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About This Manual 


Purpose 

This handbook describes the installation of the Control Data® Network Operating 
System (NOS) Version 2.7.1 and its products. NOS controls the operation of the 
following computer systems: 

• CDC CYBER 180 Computer Systems 

Models 810, 830, 835, 840, 845, 850, 855, 860, 870, 960, 990, 994, and 995 

• CDC CYBER 170 Computer Systems 

Models 171, 172, 173, 174, 175, 176, 720, 730, 740, 750, 760, 815, 825, 835, 845, 
855, 865, and 875 

• CDC CYBER 70 Computer Systems 
Models 71, 72, 73, and 74 

• CDC 6000 Computer Systems 

Audience 

Users who do not intend to modify the software should be familiar with the basic 
operations of a Control Data computer. For example, you should know how to assign 
and label tapes and how to enter commands at the system console. For this 
information, refer to the NOS Version 2 Operations Handbook and the NOS Version 2 
Reference Set, Volume 3. 

Users who intend to customize the software during installation should be familiar with 
NOS, COMPASS, and each product to be customized. In other words, you should be 
familiar with the information provided in the NOS Version 2 Analysis Handbook and 
with the information provided in reference manuals for the products you are 
customizing. 
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Manual Organization 

This handbook describes the software installation of NOS and its entire product set. 

You can disregard any information about products you have not ordered. 

This handbook is organized in the following manner: 

• Chapter 1 summarizes the four types of NOS installations, discusses dual state 
installations, and gives general guidelines for beginning all types of installations. 

• Chapter 2 describes how to install a full order of NOS and its product set for the 
first time on a dedicated system. 

• Chapter 3 describes how to install a new version of NOS on a system currently 
running a prior version of NOS. 

• Chapter 4 describes how to install additional products on a system currently 
running NOS. 

• Chapter 5 describes how to install corrective code and Batch Critical Update (BCU) 
code to a system currently running NOS. 

• Chapter 6 describes how to customize deadstart tape binaries and permanent files. 

0 Chapter 7 describes subsystem initiation, and provides special information for 
configuring and customizing NOS and each of its products. 

• Chapter 8 describes the SYSGEN utility. 

0 Chapter 9 describes special installation commands, parameters, and procedures. 

0 The five appendixes contain: a glossary of terms, the file formats of the source 
materials, special information for a 63-character set installation, Remote Diagnostic 
Facility information, and system configurations. 
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Conventions 

The following conventions are used throughout this handbook: 

• The values insun, netopun, and the netadun should be substituted throughout this 
handbook with the user names that the site is using for the installation user name, 
network operations user name, and network administration user name, respectively. 
The Control Data default values are INSTALL, NETOPS, and NETADMN. 

• CYBER 170 and 180 Computer Systems that share functional and architectural 
attributes are called CYBER 180-class machines. For example, the CYBER 180 
Computer Systems and the CYBER 170 Models 815, 825, 835, 845, and 855 are 
called CYBER 180-class machines. 

• The term CYBER 70 Computer Systems refers to models 71, 72, 73, 74, and 76 
only. 

• The terms command and control statement are interchangeable. 

• The forms of extended memory are described as follows: 

- Extended memory for models 865 and 875 and CYBER 180-class machines is 
unified extended memory (UEM) and may also include either extended core 
storage (ECS), extended semiconductor memory (ESM), or STORNET. 

- Extended memory for model 176 is large central memory extended (LCME) and 
may also include ECS or ESM. 

- Extended memory for all other NOS computer systems is either ECS, ESM, or 
STORNET. 1 

• ECS refers to ECS, ESM, and STORNET and extended memory refers to all forms 
of extended memory unless otherwise noted. However, when referencing extended 
memory in the context of an ECS multimainframe complex, a distributive data path 
(DDP), or a low-speed port (LSP) access, UEM and LCME are excluded. ECS, ESM, 
and STORNET are the only forms of extended memory that can be shared in an 
ECS multimainframe complex and can be accessed 

• Uppercase letters within command formats must be entered exactly as given; 
replace lowercase letters with appropriate characters as described in the text. 

• The values psrin and psrout are substituted throughout the text for actual PSR 
numerical values. The value psrin refers to the NOS release level and psrout refers 
to the PSR level of any products you customize when building products from source. 

• At all sites, you must specify Job and USER commands. The CHARGE command is 
not required at all sites. 

• The CDC 18002-2 console is available as an option for certain CYBER 180-class 
machines. This product includes a 721-21 display terminal and an AV117A cable. 
This console is referred to throughout this handbook as CC634B. 


1. STORNET is only supported on CYBER 170 (except model 176) and 180 Computer Systems. 
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• The CDC 19003-3 console is available as an option for certain CYBER 180-class 
machines. This product includes a video monitor, keyboard, 40-Mbyte hard disk 
(Winchester) drive, 1.2-Mbyte 5-1/2-in. floppy disk drive, 640-Kbyte RAM memory, 
one parallel printer port, and nine RS-232-C serial ports. This console is referred to 
throughout this handbook as CC598B. 

• Press CR means press the carriage return key on the CC545 console, press the 
Enter/Return key on the CC598B console, or press the NEXT key on the CC634B 
console. 


Submitting Comments 

There is a comment sheet at the back of this manual. Use it to give your opinion of 
the manual’s usability, to suggest specific improvements, and to report errors. If the 
comment sheet has already been used, you can mail your comments to: 

Control Data 

Technical Publications ARH219 
4201 North Lexington Avenue 
St. Paul, Minnesota 55126-6198 

If you have access to SOLVER, an online problem reporting facility, you can use it to 
submit comments about this manual. Use NS2 as the product identifier. 

If you have questions about the packaging and/or distribution of printed manuals, write 
to: 


Control Data 

Literature and Distribution Services 
308 North Dale Street 
St. Paul, Minnesota 55103 

Or call (612) 292-2101. If you are a Control Data employee, call (612) 292-2100. 


CYBER Software Support Hotline 

CYBER Software Support maintains a hotline to assist you if you have difficulty using 
our products. If you need help beyond that provided in the documentation or find that 
the product does not perform as described, call one of the following numbers and a 
support analyst will work with you. 

From the USA and Canada: (800) 345-9903 

From other countries: (612) 851-4131 
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Related Publications 


Control Data manuals are available through Control Data sales offices or Control Data 
Literature and Distribution Services (308 North Dale Street, St. Paul, Minnesota 
55103). 

The NOS System Information Manual is an online manual that includes brief 
descriptions of all NOS and NOS product manuals. To access this manual, log in to 
NOS and enter the command EXPLAIN. 

Programming information for the various forms of extended memory is in the 
COMPASS Reference Manual and in the appropriate computer system hardware 
reference manual. 


CDCNET Manuals 

Control Data Publication 
CDCNET Configuration and Site Administration 
CDCNET Network Operations 
CDCNET TCP/IP Usage 

Extended Memory Manuals 

Control Data Publication 

CYBER 5380-100 STORNET Subsystem (SNSS) 

Hardware Reference Manual 

Extended Core Storage Reference Manual 

Extended Core Storage II and Distributive Data Path 
Reference Manual 

Extended Semiconductor Memory Hardware Reference Manual 


Publication 

Number 

60461550 

60461520 

60000214 


Publication 

Number 

60000188 

60347100 

60430000 

60455990 
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Hardware Manuals 


| Control Data Publication 

| CYBER 70 Model 71 Computer System Hardware Reference Manual 

| CYBER 70 Model 72 Computer System Hardware Reference Manual 

1 CYBER 170 Computer Systems Models 171 through 175 
I (Levels A, B, C) Model 176 (Level A, B, C) 

Hardware Reference Manual 

| CYBER 170 Computer Systems Models 720, 730, 740, 750, and 760 
| Model 176 (Level B/C) Hardware Reference Manual 

CYBER 170 Computer Systems Models 815 and 825 
1 Hardware Reference Manual 

| CYBER 170 Computer Systems Models 835, 845, and 855 
CYBER 180 Computer Systems 
1 Models 835, 840, 845, 850, 855, 860, and 990 

CYBER 990E, 995E, and 994 Computer Systems CYBER 170 State 
| Hardware Reference Manual 

| CYBER 170 Computer Systems Models 835, 845, and 855 
| CYBER 180 Computer Systems Models 835, 845, and 855 
| Hardware Operator’s Guide 

CYBER 170 Computer Systems Models 865 and 875 
| Hardware Reference Manual 

CYBER 180 Models 810 and 830 Computer Systems 
Hardware Operator’s Guide 

| CYBER 180 Models 810 and 830 Computer Systems 
| Hardware Reference Manual 

| CYBER 840A, 850A, 860A, and 870A Computer Systems 
Hardware Reference Manual 

| CYBER 960 Computer Systems 
| CYBER 170 State 
| Hardware Reference Manual 

19003-3 System Console CC598B Hardware Operation/ 

| Maintenance Guide 

380-170 Network Access Device Hardware Reference Manual 


Publication 

Number 

60453300 

60347000 

60420000 

60456100 

60469350 

60469290 

60458390 

60458920 

60469440 

60469420 

60463560 

60000127 

60463610 

60458500 
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NOS 2 Manuals 


Control Data Publication 

Common Memory Manager Version 1 Reference Manual 

COMPASS Version 3 Reference Manual 

CYBER Initialization Package (CIP) Reference Manual 

CYBER Loader Version 1 Reference Manual 

CYBER Record Manager Advanced Access Methods Version 2 
Reference Manual 

CYBER Record Manager Basic Access Methods Version 1.5 
Reference Manual 

FORM Version 1 Reference Manual 

Modify Version 1 Reference Manual 

NOS Online Maintenance Software Reference Manual 

NOS Version 2 Administration Handbook 

NOS Version 2 Analysis Handbook 

NOS Version 2 Applications Programmer’s Instant 

NOS Version 2 Diagnostic Index 

NOS Version 2 Full Screen Editor User’s Guide 

NOS Version 2 Operations Handbook 

NOS Version 2 Reference Set, Volume 3, System Commands 
NOS Version 2 Reference Set, Volume 4, Program Interface 
NOS Version 2 Screen Formatting Reference Manual 
NOS Version 2 Security Administrator’s Handbook 
NOS Version 2 Systems Programmer’s Instant 
SYMPL Version 1 Reference Manual 


Publication 

Number 

60499200 

60492600 

60457180 

60429800 

60499300 

60495700 

60496200 

60450100 

60454200 

60459840 

60459300 

60459360 

60459390 

60460420 

60459310 

60459680 

60459690 

60460430 

60460410 

60459370 

60496400 
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Optional Product Manuals 


Control Data Publication 

APL Version 2 Reference Manual 

BASIC Version 3 Reference Manual 

COBOL Version 5 Reference Manual 

Concurrent Maintenance Library Reference Manual 

CYBER Cross System Version 1 Build Utilities Reference Manual 

CYBER Cross System Version 1 Macro Assembler Reference Manual 
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Introduction 


1 


Installation Process 

Installation is the process of creating an operating system deadstart file and then using 
the deadstart file to load the operating system and its products into the computer. 
Loading the system means copying the information on the deadstart file to specific 
locations in central memory and to disk. The deadstart file, which can reside on tape 
or disk, contains binary information created by assembling operating system and 
product set source code. 

In addition to the information on the deadstart file, you must also copy several 
permanent files to disk, including configuration files that describe the hardware and 
software components of your system. Most of the permanent files you need are released 
on the permanent file tapes. You create the configuration files for your system using 
sample configuration files provided by Control Data. 


Types of Installations 

Four types of NOS system installations are described in this handbook: 

• First-Time Installation. Chapter 2 describes how to install a full order of NOS and 
its product set on a dedicated system. This type of installation is started from the 
system console. Instructions are included for bringing up an interactive terminal to 
aid in the installation process. 

• Upgrade Installation. Chapter 3 describes how to install a new version of NOS on a 
system currently running a prior version of NOS. Many of the activities performed 
in this installation can be initiated from an interactive terminal. 

• Component Order Installation. Chapter 4 describes how to install additional products 
on a system currently running NOS. The PSR level of the components you want to 
install must be the same as that of the NOS software running on your system. 

• Corrective Code Installation. Chapter 5 describes how to install corrective code and 
Batch Critical Updates (BCUs) to a system currently running NOS. 


Customizing Installations 

Regardless of the type of installation you perform, you can customize NOS or other 
products during installation. If you want to customize portions of the software you 
install, first follow the steps for the type of installation you will be performing 
(described in chapter 2, 3, 4, or 5). When you are directed to do so, refer to chapters 6 
and 7 for specific information about customizing the installation procedures and specific 
products. 


Revision L 


Introduction 1-1 




Dual State Installations 


Dual State Installations 

If you want to install a dual state system (that is, one that concurrently runs both 
NOS and NOS/VE), refer to the chart below for instructions on when to refer to this 
installation handbook and to the NOS/VE Software Release Bulletin (SRB). 

If you want to Then 


Perform a first-time installation of 1. 
NOS and NOS/VE 

2 . 


Add dual state and upgrade your 1. 
NOS system at the same time 

2 . 


Add dual state and not update your 1. 
current NOS system 


2 . 


Upgrade dual state and NOS 1. 


2 . 


Follow the instructions in this handbook for 
a first-time NOS installation. 

Once you have completed the NOS 
installation (including dual state 
preparations) and have re-deadstarted your 
system, go to the NOS/VE SRB and follow 
the instructions for a first-time installation 
of dual state. 

Follow the instructions for an upgrade 
installation in this handbook. 

Once you have completed the NOS 
installation (including dual state 
preparations) and have re-deadstarted your 
system, go to the NOS/VE SRB and follow 
the instructions for a first-time installation 
of dual state. 

Follow the instructions for an upgrade 
installation in this handbook. However, skip 
the steps that describe how to update NOS 
products. 

Once you have completed dual state 
preparations and have re-deadstarted your 
system, go to the NOS/VE SRB and follow 
the instructions for a first-time installation 
of dual state. 

Follow the instructions in this handbook for 
an upgrade installation. 

Once you have completed the NOS 
installation and have re-deadstarted your 
system, go to the_ NOS/VE SRB and follow 
the instructions for upgrading a dual state 
system. 
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Preparing for an Installation 


If you want to 


Then 


Upgrade only dual state and not 
upgrade NOS 


1. Follow the instructions specified in Dual 
State on Older NOS Systems in the DUAL 
section of chapter 7. 

2. Re-deadstart your system with the new tape, 
go to the NOS/VE SRB and follow the 
instructions for upgrading a dual state 
system. 


Upgrade only NOS and not upgrade 1. 
dual state 


Follow the instructions in this handbook for 
an upgrade installation. Note that you will 
be instructed to reassemble the dual state 
binaries. 


Apply corrective code to a dual 1. 

state system 


Go to chapter 5 of this handbook for 
information about applying a BCU to a dual 
state system. For information about applying 
corrections to NOS/VE, refer to the NOS/VE 
SRB. 


Preparing for an Installation 

Before you begin any type of NOS installation, you need to: 

• Collect all release tapes 

• Collect and update manuals 

• Read all release bulletins 

These tasks are described in the following paragraphs. 

Collect All Release Tapes 

You need the following tapes to install NOS and any optional products: 

© Deadstart Tape. This tape contains all the executable programs for NOS and the 
products you have ordered. These programs were built according to the information 
you specified in the Order Information Package (OIP). 

• Permanent File Tapes. These tapes contain the permanent files your system needs 
to run. These tapes also contain the source code for your system. You can use the 
source code if you want to perform a customized installation. 

NOTE _ 

If you ordered only a software component (not NOS) or received a Batch Critical 

Update (BCU), the executable programs and source code for your component order are 

released on permanent file tapes and you will not receive a deadstart tape. 
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Collect and Update Manuals 

A complement of manuals is sent with each release. Manuals that have been 
completely revised since the last edition have a yellow cover sheet. You can discard 
your last edition of these manuals. Revision packets, if any, have a pink cover sheet. 
The pink cover sheet explains which pages are to be inserted or removed from the last 
edition of the manual. 

Read All Release Bulletins 

There are two types of documents you should read before performing an installation: 
the Software Release Bulletin and Installation Bulletins. 

A Software Release Bulletin (SRB) is issued with each NOS release and contains 
up-to-the minute information that is specific to the release. A printed copy of the SRB 
is included with your release materials. In addition, a copy of the SRB is released on a 
separate tape. 

Installation Bulletins (IBs) may be issued to communicate information that is 
discovered after the release has been forwarded to customers. You can access IBs 
through SOLVER. 

SOLVER is an interactive program that allows you to access the Programming Systems 
Report (PSR) database. By using SOLVER, you can: 

• List IBs associated with the system you are installing. 

• Report software problems to Control Data. 

• Check the status of problem reports. 

• Search for similar problems reported by other customers. 

You can access SOLVER through direct dial or Telenet lines. Contact your local 
Control Data Professional Services office for complete access information. 
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Introduction 

This chapter describes how to install a full order of NOS and its product set for the 
first time on a dedicated system. This type of installation is started from the system 
console and includes instructions for bringing up an interactive terminal to aid in the 
installation process. 

A first-time installation consists of the steps listed below. These steps are described in 
the remaining sections of this chapter: 

1. Prepare for the Installation 

2. Deadstart the System 

3. Install Permanent Files 

4. Bring Up a Network Terminal 

5. Configure the System 

6. Deadstart the New System 

7. Wrap Up 

If you want to customize any deadstart tape binaries or permanent files, first complete 
the first-time installation instructions in this chapter and then continue with your 
installation by following the directions in chapter 6 of this handbook. 

If you are installing a dual state system, install NOS according to the steps in this 
chapter, then follow the dual state instructions in the NOS/VE SRB. 
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Step 1: Prepare for the Installation 

Your computer system consists of a unique combination of hardware and software 
components. During the installation process, you must define the attributes of your 
mainframe, the hardware devices connected to your mainframe, how the hardware 
should be used by the system, the software installed at your site, and how the software 
should be used by the system. 

The process of defining the hardware and software components of your system is called 
configuring the system. Configuring the system consists of two steps: determining your 
site’s hardware and software components; and then, based on these components, 
creating deadstart decks and configuration files to store the information. 

This section gives guidelines for gathering the configuration information you need to 
create deadstart decks and configuration files. This section covers the following topics: 

• Hardware Inventory 

• Software Inventory 

• Deadstart Deck Requirements 

• Configuration File Requirements 

• Initial Deadstart Preparation 

Hardware Inventory 

Get a description of your site’s computer system hardware configuration from your 
hardware installer. This description should include the attributes of your mainframe 
and the peripherals connected to the computer. 

For the mainframe, determine: 

• Amount of physical memory (how many megabytes) 

• Model number (for example, 180-860) 

• Number of central processing units (CPUs) 

• Number of peripheral processors (PPs) 

• Number and types of channels 
For each peripheral device, determine: 

• Peripheral type (for example, 895 disk) 

• Channel numbers to which each peripheral is connected 

• Peripheral equipment number and unit number 

• Other information unique to the type of peripheral 
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If your site contains multiple mainframes, you should also determine what other 
mainframes may share or use these peripherals. 

Once you have gathered all the hardware information for your site, use this 
information to create a configuration chart showing the layout of your hardware. This 
chart will assist you when you create deadstart decks and configuration files. 


Software Inventory 

To determine the software components of your system, refer to the Component List 
report which is included with your release tapes. This report, produced by Software 
Manufacturing and Distribution (SMD), lists the names and product numbers of all 
software shipped with your order. In addition, it lists the software options selected for 
each product. This information is based on the software options selected on the Order 
Information Package (OIP) for your site. You should compare the Component List 
report with the OIP to verify that you have received the products that were ordered. 

Deadstart Deck Requirements 

Configuration information is stored in text records on the deadstart tape called 
deadstart decks. There are five types of deadstart decks: 

• CMRDECK (Central Memory Resident Deck). CMRDECK entries describe how 
central memory is used during system operation. 

® EQPDECK (Equipment Deck). EQPDECK entries describe how hardware components 
(such as disks, tapes, printers, network hardware, and other equipment) are 
connected to the mainframe and how these components are used by the system. 

• APRDECK (Auxiliary Mass Storage Parameter Deck). APRDECK entries identify 
locations on mass storage (disks) that are unusable or flawed. 

• IPRDECK (Installation Parameter Deck). IPRDECK entries specify the default mode 
of system operation. 

• LIBDECK (Library Edit Deck). LIBDECK entries specify the attributes of the 
programs on the deadstart tape. 

Refer to the NOS Version 2 Analysis Handbook for more information about deadstart 
deck entries for both hardware and software. Refer to chapter 7 in this handbook for 
deadstart deck information for specific software products. 

The released deadstart tape contains preconfigured deadstart decks that describe several 
standard mainframe configurations. Use these preconfigured decks as a starting point 
to create deadstart decks for your site. You can also use the preconfigured decks for 
the first deadstart of the system before installing and configuring the system. Tables 
2-3, 2-4, and 2-5 list the released deadstart decks. Refer to Initial Deadstart 
Preparation later in this step for information about using the decks during deadstart. 

In general, each hardware component requires one or more entries in the EQPDECK. 
The software products that require deadstart deck entries are listed in table 2-1. 
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Table 2-1. Software Products and Deadstart Deck Requirements 


Product 

Deadstart Decks 

Dual State 

CMRDECK, EQPDECK 

Mass Storage Extended 

EQPDECK 

NAM/CCP Network 

EQPDECK 

NAM/CDCNET Network 

EQPDECK 

NOS 

CMRDECK, EQPDECK, APRDECK 

NOS Scope Station Facility 

CMRDECK, EQPDECK 

PTF/QTF File Transfer Facility 

CMRDECK 

Remote Host Facility 

CMRDECK, EQPDECK 

Configuration File Requirements 

Some software products require configuration files. To install these products, you must 
create the required configuration files. Table 2-2 lists the software products that 
require configuration files and the corresponding file names. Refer to chapter 7 of this 
handbook for specific configuration information for each of the products listed in this 
table. 

Table 2-2. Software Products and Configuration Files Required 

Product 

Configuration Files 

Dual State 

LIDCMid, LIDVEid 

Mass Storage Extended 

MSECONF 

NAM/CCP Network 

LCFFILE, NCFFILE, NLFFILE 

NAM/CDCNET Network 

CDCNET 1 , LCFFILE 

NOS Scope Station Facility 

LIDCMid 

Printer Support Utility 

CDCNET 1 , EVFULFN, LCFFILE, NCFFILE 

PTF/QTF (NAM/CCP) 

LCFFILE, LIDCMid, NCFFILE, NLFFILE 

PTF/QTF (NAM/CDCNET) 

CDCNET 1 , LCFFILE, LIDCMid 

PTF/QTF (RHF) 

LIDCMid, RCFMid 

Remote Host Facility 

LIDCMid, RCFMid 

TCP/IP/FTP/TELNET 

TCPHOST 

1. CDCNET has numerous configuration files. 
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Initial Deadstart Preparation 

The first time you deadstart the system (refer to Step 2: Deadstart the System), use 
the preconfigured deadstart decks released on the deadstart tape. The preconfigured 
decks are listed in tables 2-3, 2-4, and 2-5. 

There are three types of preconfigured decks: 

• CYBER 810/830 mainframes running NOS. 

• Other mainframes running NOS. 

• Mainframes running dual state systems. 

All the decks include a 255x NPU configured on channel 7, node 1 and a CDCNET 
MDI/MTI configured on channel 7. Table sizes (CMRDECK) are set according to 
memory size. Main memory and ESM sizes are given in 60-bit words, except for dual 
state decks (42-44), which use megabytes. 

• CMRD00 is a directory for all released deadstart decks. 

• CMRD35 is an unconfigured CMRDECK, therefore EQPD35 contains no equipment 
definitions. 

• IPRD01 is for the 810/830, which uses the asynchronous printer and 639 tape 
drives. 

• IPRD00 is for all other mainframes. 

• LIBD00 is for mainframes without UEM or ESM. 

• LIBD01 is for mainframes with ESM. 

• LIBD02 is for mainframes with UEM. 

Select the decks that describe a configuration that closely resembles your site’s 
configuration. You should not need to modify the default CMRDECK entries in the 
released deck. However, you will need to make EQPDECK entries to define the 
physical locations of a few system and temporary file disks, all the disks in your 
default family, your tape drives, and your printer. You should also properly define any 
UEM and the channel and equipment numbers for your 255x NPU or CDCNET DI. For 
this initial deadstart, you do not need to define any disk or tape equipment that will 
be assigned to NOS/VE in your actual production system. Also, you do not need to 
define equipment for RHF, MSE, or NOS Scope Station. 
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Table 2-3. Preconfigured Deadstart Decks (NOS 810/830 Decks) 


Deck 

Memory 

Equipment 





Number 

Size 

Type 

Channel 

UN or EQ 

01 

262K 

639 Tape 

CH 

= 

6 




836 Disk 

ASY Printer 1 

CH 

— 

0 

UN = 0 

02 

262K 

639 Tape 

CH 


6 




836 Disk 

ASY Printer 1 

CH 

= 

0 

UN = 0,1 

36 

262K 

639 Tape 

CH 


6 




834 Disk 

ASY Printer 1 

CH 


0 

UN = 0 

37 

262K 

639 Tape 

CH 


6 




834 Disk 

ASY Printer 1 

CH 

= 

0 

UN = 0,1 

03 

512K 

639 Tape 

CH 

— 

6 




836 Disk 

ASY Printer 1 

CH 

= 

0 

UN = 0,1 

04 

512K 

679 Tape 

CH 

— 

31 




885 Disk 

CH 

= 

1 

UN = 40,41 



580 Printer 

CH 

= 

12 

EQ = 5 

40 

512K 

639 Tape 

CH 

zr 

6 ' 




834 Disk 

ASY Printer 1 

CH 

— 

0 

UN = 0,1 

05 

> = 1000K 

639 Tape 

CH 


6 




836 Disk 

ASY Printer 1 

CH 

— 

0 

UN = 0,1 

06 

> =1000K 

679 Tape 

CH 

— 

31 




885 Disk 

CH 

= 

1 

UN = 40,41 



580 Printer 

CH 

= 

12 

EQ = 5 

41 

> = 1000K 

639 Tape 

CH 

= 

6 




834 Disk 

ASY Printer 1 

CH 


0 

UN = 0,1 

1. ASY printer is an asynchronous printer connected to 

a 

255x NPU, a CDCNET MTI, 

or a CDCNET MDI/TDI. 
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Table 2-4. Preconfigured Deadstart Decks (NOS Non-810/830 Decks) 


Deck 

Number 

Memory 

Size 

ESM Size 

Disk 

Type 

UN 

07 

262K 


844 

0,1 

10 

262K 


885-12 

40,41 

11 

512K 


844 

0,1 

12 

512K 


885-12 

40,41 

13 

512K 


895 

40,41 

14 

1000K 


844 

0,1 

15 

1000K 


885-12 

40,41 

45 

1000K 


887 

0,1 

16 

1000K 


895 

40,41 

47 

1000K 


9853 

0,1 

17 

2000K 


885-12 

40,41 

46 

2000K 


887 

0,1 

20 

2000K 


895 

40,41 

21 

262K 

1000K 

844 

0,1 

22 

262K 

1000K 

885-12 

40,41 

23 

262K 

1000K 

885-42 

40,41 

24 

262K 

2000K 

844 

0,1 

25 

262K 

2000K 

885-12 

40,41 

26 

262K 

2000K 

885-42 

40,41 

27 

>=512K 

1000K 

844 

0,1 

30 

>=512K 

1000K 

885-12 

40,41 

31 

> = 512K 

1000K 

885-42 

40,41 

32 

>=512K 

2000K 

844 

0,1 

33 

> = 512K 

2000K 

885-12 

40,41 

34 

>=512K 

2000K 

885-42 

40,41 

All non-810/830 decks contain two 67x tape drives (units 0 and 1) 
printer is a 580 on channel 12, equipment 5. 

on channel 13. The 
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Table 2-5. Preconfigured Deadstart Decks (Dual State Decks) 


Deck 

Number 

Mainframe 

Type 

Memory 

Total 

NOS 

Memory 

(MBs) 

UEM 

Memory 

(MBs) 

VE 

Memory 

(MBs) 

Disk 

Type 

42 

810/830 

12 

3.5 

2 

6.5 

836 

43 

Non-810/830 

16 

6 

2 

8 

885-12 

44 

Non-810/830 

32 

4 

4 

24 

895 
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Step 2: Deadstart the System 

The CYBER Initialization Package (CIP) tape contains hardware and software interface 
modules that allow NOS to run on a CYBER mainframe. CIP is delivered with your 
NOS order. If you have an 800 series computer, the CIP modules must be installed to 
disk. If you have a non-800 series computer, installing the CIP modules is optional. 
Check with your customer engineer (CE) to ensure that CIP has been installed; CIP 
installation should be a cooperative effort between you and your CE. 

Using the preconfigured deadstart decks you selected in Step 1 and the released 
deadstart tape, deadstart the system following the instructions given below. For more 
detailed information on the deadstart process, refer to the NOS Version 2 Operations 
Handbook; for details on the deadstart panel settings, refer to the CIP User’s 
Handbook. 

1. Mount the released deadstart tape on an available tape unit. 

2. Set your deadstart panel (or deadstart display) to specify a level 0 deadstart from 
the preconfigured CMRDECK you want to use to deadstart your system. 

• For CYBER 800 series computers or non-800 series computers where CIP has 
been installed, set up the panel for a disk deadstart from the disk unit that 
contains the CYBER Initialization Package (CIP). 

• For non-800 series computers where no CIP has been installed, specify a tape 
deadstart from the unit where you mounted the deadstart tape. 

3. Initiate the deadstart sequence. 

• On the CC545 console, press the deadstart button. 

• On the CC598B console, press CTRL F2. 

• On the CC634B console, press the RESET key to reinitialize the console. Next, 
press CTRL G and then press CTRL R. 

4. Advance to the Initial Options display. 

• For models with a deadstart panel display, press CR. 

• For models 810, 830, 840A, 850A, 860A, 960, 990A, 994, and 995A, the Initial 
Deadstart display appears after you initiate the deadstart sequence. If you select 
S on this display, the Initial Options display appears. 

• For all models except 810, 830, 840A, 850A, 860A, 960, 990A, 994, and 995A, 
the Initial Options display appears after you initiate the deadstart sequence. 

5. Check the deadstart panel settings. 

a. Enter O to select operator intervention. 

b. Toggle the deadstart state to NOS deadstart. 

c. Enter P to check the deadstart panel settings. Set the DISPLAY CMRDECK 
option to YES. 

d. Press the backspace key to return to the O display. 


Revision L 


First-Time Installation 2-9 



Step 2: Deadstart the System 


6. Advance to the CMRDECK display. 

• For all CYBER 800 series computers and models 960, 990, 994, and 995, enter 
S to select the deadstart device and then enter T to specify operating system 
deadstart from tape. Next, enter the tape channel, equipment, and unit numbers 
that describe where the deadstart tape is mounted. 

• For all other models, press the CR key. 

7. Enter CMRDECK entries. 

a. An instructional display (CMRINST) gives the format for CMRDECK entries. To 
advance to the screen for entering data: 

• On the CC545 console, press the right blank key. 

• On the CC598B console, press the tab key. 

• On the CC634B console, press the right tab key. 

b. Enter any CMRDECK changes. When you have finished, enter: 

NEXT. 

8. Enter EQPDECK entries. 

a. An instructional display (EQPINST) gives the format for EQPDECK entries. To 
advance to the screen for entering data: 

• On the CC545 console, press the right blank key. 

• On the CC598B console, press the tab key. 

® On the CC634B console, press the right tab key. 

b. Enter EQPDECK entries to describe your hardware configuration. When you 
have finished, enter: 

GO. 

The system now begins loading. If you are requested to do so, enter the current date 
and time. When the system is loaded, the initial A and B displays appear. 
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Step 3: Install Permanent Files 

The permanent files for your system are released on the permanent file tapes. You 
install these files by using a SYSGEN command. SYSGEN automatically creates initial 
validation files for your system and loads files from the permanent file tapes to the 
various user names required for system operation. In addition to files required for 
system operation, initial configuration files for NAM/CCP and NAM/CDCNET networks, 
online manuals and help files are also loaded to disk. 

To install all permanent files, follow these steps: 

1. From the system console, enter the following command: 

X.SYSGEN(FULL) 

2. Mount the requested permanent file tape on an appropriate tape unit when you are 
prompted to do so. The volume serial number (VSN) for each tape is printed in the 
media number field of the external tape label. SYSGEN automatically assigns the 
tape. When this procedure is completed, you will see the following message in the 
system dayfile: 

***** end SYSGEN ************** 

All the necessary permanent files are set up on your default family device. 
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Step 4: Bring Up a Network Terminal 

When you installed the permanent files for the system, the files necessary for 
configuring a single line were automatically loaded on the system. Control Data has 
two networks: 

• NAM/CDCNET 

• NAM/CCP 

Read the hardware requirements pertaining to the network you have installed. Then, 
follow the steps for activating the network installed on your system. 

NAM/CDCNET (DI Requirements and Information) 

Here are the minimum hardware requirements for configuring one line: 

• A CDCNET Device Interface (DI) configured as a Mainframe Terminal Interface 
(MTI). An MTI contains lines and terminals and is connected to the mainframe via 
a CYBER channel. 

• Two CDCNET DIs: one configured as a Mainframe Device Interface (MDI) and one 
configured as a Terminal Device Interface (TDI). An MDI contains an Ethernet 
cable and is connected to the mainframe by a CYBER channel. It has no lines or 
terminals. A TDI contains lines and terminals and is connected to an Ethernet 
cable, not a CYBER channel. 

The MTI or TDI must contain an asynchronous line connected to LIM 0, PORT 0. That 
line and the terminal connected to it have been pre-defined in CDCNET configuration 
files and are used to complete the installation and configuration of the system. If no 
line is connected to LIM 0 PORT 0, either physically move a line there or once the DI 
is loaded, use the Network Operator Utility (NETOU) via its K display to define the 
line. NETOU is described in the CDCNET Network Operations Manual. 

To use the terminal, you must inform the CDCNET software of the system identifiers 
(serial numbers) of your DIs. Do this by entering the following commands: 

1. Define the system IDs of each DI in the network using procedure ADDDI (ADD_ 
DEVICE_INTERFACE). Enter the following commands from the system console: 

X.DIS. 

USER,NETADMN.NETADMN. 

BEGIN,ADDDI,DCNPLIB,type,Si. 

Parameter Description 

type Type of DI (MDI or MTI). 

si Last 6 digits of the DI’s system identifier. The DI system identifier 

is a 12-digit number that can be found printed on a tag attached to 
the inside of the DI cabinet. Note that the tag contains a 4-digit 
checksum appended to the 12-digit system identifier. Do not include 
the checksum in this parameter. 

If you configured an MDI in step 1, perform step 2; if you configured 
an MTI, skip to step 3. 
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2. Execute the ADDDI procedure again to define your TDI. Specify the DI’s system 
identifier (si): 

BEGIN,ADDDI,DCNPLIB,TDI,si. 

3. Terminate the DIS package: 

DROP. 

To use the terminal, initiate the network by following the steps in Activating the 
Network, described later in this section. 

NAM/CCP ( 255 x Requirements and Information) 

The minimum hardware requirements for configuring one line are a 65K NPU 
connected via a channel to your mainframe. The NPU should contain at least one 
2561-x CLA for use with an asynchronous line and terminal. The terminal line should 
be connected to the CLA and the CLA dialed to PORT 0A(16) to run at 600-9600 baud 
or to PORT 10(16) to run at 110-2400 baud. 

To use the terminal, initiate the network by following the steps in Activating the 
Network, described next. 
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Activating the Network 

To activate the network, perform the following steps: 

1. Make sure the EST ordinal number for either your 255x NPU (EST number 60) or 
your MDI or MTI (EST number 61) is turned on. This can be determined by 
checking the E,. display (an NPU is type NP; a DI is type ND). If the one you are 
to use is off, turn it on by entering this command at the system console: 

ON,EQ=xx. 

Replace xx with the EST number for the 255x NPU or CDCNET DI. 

2. Reset all DIs or NPUs to ensure the software is loaded with the proper 
configuration. 

3. Initiate NAM and IAF by entering: 

NAM. 

IAF. 

It will take several minutes to ready the subsystems and load the 255x or DI 
hardware. NAM will submit numerous other applications to aid in configuring and 
loading the network. 

4. Log in to the system. For CDCNET networks, you must first create a connection to 
the default NOS system name. To do so, use the following command: 

CREC NOS_SYSTEM 
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Step 5: Configure the System 

During this step, you will create a new deadstart file (or tape) containing a permanent 
copy of your deadstart decks; you will also create and/or modify your configuration 
files. 

Deadstart Decks 

Before creating deadstart decks, refer to table 2-1 for the list of products that require 
deadstart deck entries. Chapter 7 gives more detailed information about product 
deadstart deck entries. 

Perform the following steps from an interactive terminal logged in to the installation 
user name. The default is INSTALL. For a list of default system passwords, refer to 
SYSGEN Validations in chapter 8. You will need an unlabeled scratch tape for the new 
deadstart tape. 

1. Get a copy of the deadstart decks (CMRDECK, EQPDECK, and so forth) you used 
in Step 2. Use the following commands: 

COMMON,SYSTEM. 

GTR,SYSTEM,DSTDECK.deckname1.decknamen 

Replace decknamei through decknamen with the names of the deadstart decks you 
want to update--for example, CMRD03 for CMRDECK 03, EQPD03 for EQPDECK 
03, and so forth. 

2. Use an available editor (such as FSE or XEDIT) to make any necessary changes to 
the deadstart decks on file DSTDECK. 

3. When you have made all the necessary changes to the deadstart decks, use the 
following command to merge the records on file DSTDECK with the contents of 
your current system: 

SYSGEN,DST,SYSTEM,DSTDECK,NEW,0,density. 

Replace density with the tape density you want to use for the new deadstart tape 
(HY, HD, PE, or GE). 

4. When a tape request is issued, mount an unlabeled scratch tape. Then enter this 
command at the system console to assign the tape: 

vSN.est,NDT. 

Replace est with the Equipment Status Table (EST) ordinal number of the tape 
drive unit where your tape is mounted. 

When this procedure has finished executing, you have a new deadstart tape to use for 
subsequent deadstarts. 

Configuration Files 

After you have created your new deadstart tape, you should create the configuration 
files needed to operate your system. Table 2-2 lists the products that require 
configuration file entries. Refer to chapter 7 for information on creating and moving 
the configuration files. 
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Step 6: Deadstart the New System 

1. When you have moved all the configuration files to the proper user names, 
terminate all NAM and IAF subsystem activity. To do so, enter the following 
commands from the system console: 

K,NAM. 

K.AP=NVF. 

K.ID,HOST. 

IDLE,IAF. 

2. Wait for all system activity to complete. Then perform a permanent file backup 
(PFDUMP) if desired. Consult the NOS Version 2 Analysis Handbook for 
information on the PFDUMP utility. 

3. Shut down the system by entering the following commands from the system console: 

UNLOCK. 

CHECK POINT SYSTEM. 

4. Deadstart the new system using the deadstart tape you built in Step 5. Follow the 
directions for deadstarting the system given in Step 2. Because the default family 
device contains the permanent files needed to run the system, do not initialize that 
device. 
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Step 7: Wrap Up 

You have now completed the first-time installation process. If you need to customize 
the system, go to chapter 6 for more installation information. If you are installing a 
dual state system, go to the NOS/VE SRB. The following three items contain 
suggestions that you may wish to consider. 

User Names and Passwords 

For security reasons, it is suggested that the passwords for the system user names be 
changed upon completion of the installation. Also, SYSGEN automatically created user 
names for all products; you can delete the user names of products your site did not 
install. Refer to SYSGEN Validations in chapter 8 for information on modifying 
passwords. 

You should also create user names and passwords for the users of the system. Refer to 
the NOS Version 2 Administration Handbook for information on creating user names 
and passwords. 

Installation of Online Manuals 

The permanent file tapes contain both the source and bound files for each online 
manual. SYSGEN automatically installs all the bound online manual files and a 
procedure file called MANLOAD on user name MANUALS. You can access the bound 
version of the online manuals with the EXPLAIN command. If you want to modify any 
of the online manuals, you can use the MANLOAD procedure to install the source 
version of the manuals. Because the online manuals use a great amount of disk space, 
you should delete any manuals you do not need once installation is completed. 


Installation of Concurrent Maintenance Library (CML) 

The permanent file tapes contain the most recent version of CML at the time NOS 
released. It was automatically installed as file CML3 to user name CDCCE by the 
X.SYSGEN(FULL) command executed in Step 3. You should inform your customer 
engineer (CE) that the file is available. Also, because the file takes up a large amount 
of disk space, you should request that your CE remove any unnecessary diagnostics 
once installation is complete. 
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Introduction 

The steps in this chapter describe how to install -a new release of NOS on a system 
that is currently running a prior release of NOS. If you are upgrading a dual state 
system, follow these same instructions. 

The installation steps are designed to allow you to perform as much of the upgrade as 
possible on your existing NOS system before you deadstart the new release tape. Most 
of the steps can be performed from an interactive terminal running on your current 
production system. 

An upgrade installation consists of the steps listed below. These steps are described in 
the remaining sections of this chapter. If you are installing any new products with this 
upgrade, you will find it helpful to review the steps in chapter 2, First-Time 
Installation. 

1. Create New User Names 

2. Set Up Installation Tools 

3. Update Decks and Configuration Files 

4. Write a New Deadstart Tape 

5. Override Automatic File Installation 

6. Install Permanent Files 

7. Deadstart the New System 

Consult the Software Release Bulletin (SRB) and any Installation Bulletins (IBs) for 
important notes or cautions before upgrading to the new release of NOS. 
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Step 1: Create New User Names 


Step 1: Create New User Names 

For each product that you are installing for the first time, create the user names 
necessary for running the product. By creating the user names now, you can install 
files to the user names before deadstarting the new system. To determine the new user 
names, refer to these sources: 

• The SRB lists any user names that are new for this release. 

• Table 8-1 (in chapter 8) lists all of the user names on which the system will store 
files and the products that use those user names. 

| If you wish to change the default Control Data installation user names to ones that are 
site-defined, the site user names must be created now. The user names involved are 
the installation user name (default INSTALL), the network operations user name 
| (default NETOPS), and the network administration user name (default NETADMN). 
Please note that the user names you choose should have similar validations to the 
default values supplied by Control Data. 

| Any new user names must be created/updated from the system console using the 
MODVAL utility. Refer to the NOS Version 2 Administration Handbook for details 
| about MODVAL. 

| In addition to creating the new user names, you must update your ZZSYSGU file that 
| SYSGEN uses for executing USER commands. SYSGEN expects file ZZSYSGU to be 
present on user name SYSTEMX. If the NOS system you are upgrading is a pre-level 
I 664/650 system or file ZZSYSGU is not present on user name SYSTEMX, perform step 
1; otherwise skip to step 2. 

| 1. Copy the released deadstart tape to a local file named SYSTEM and execute the 
SYSGEN command that saves file ZZSYSGU on user name SYSTEMX. 

REQUEST,TAPE,VSN=vsn,D=dens1ty,LB=KU,F=I,P0=R. 

COPYEI,TAPE,SYSTEM,V. 

UNLOAD,TAPE. 

BEGIN,SYSGEN,SYSTEM,LOADUSE. 

Replace vsn with the VSN of the released deadstart tape; replace density with the 
density of that tape. 

2. Modify ZZSYSGU to contain the correct user names and passwords for your site. 
Refer to SYSGEN Validations in chapter 8 for more information. 
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Step 2: Set Up Installation Tools 


Step 2: Set Up Installation Tools 

This step sets up the RECLAIM database and a global library of tools to help 
recompile configuration files. By setting up the RECLAIM database, you can perform 
much of the upgrade work before deadstarting the new system. 

You will need the new released deadstart tape. If you are customizing, you will also 
need the new released permanent file tapes. Perform the following steps: 

1. Log in to your installation user name using an interactive terminal. 

2. Copy the new released deadstart tape to a local file named SYSTEM: 

REQUEST,TAPE,VSN=vsn,D=density,LB=KU,F=I,PO=R. 

Replace vsn with the VSN of the released deadstart tape (contained in the media 
number field of the external tape label). Replace density with the tape density of 
the tape (HY, HD, PE, or GE). 

COPYEI,TAPE,SYSTEM,V. 

UNLOAD,TAPE. 

NOTE 


Execute the instructions in chapter 6 if you wish to do any of the following tasks: 

• Customize NOS or its products 

• Install a newer version of NOS with an older verion of NOS/VE (for example, 
NOS L688 with NOS/VE L678) 

• Change the default Control Data installation user names (INSTALL, NETOPS, 
and NETADMN) to ones defined by the site 

Pay close attention to the introductory notes in chapter 6. When you have 
completed the steps in chapter 6, continue the upgrade with Step 3: Update Decks 
and Configuration Files, in this chapter. 


3. Set up the RECLAIM database and global library file by entering the following 
commands: 

GTR,SYSTEM,PFG.ULIB/PFGLIB 
BEGIN,SYSGEN,SYSTEM,INIT,UPGRADE. 

When this procedure is completed, you have created the following files: 

• RECLDB, a new RECLAIM database, containing information about all the files on 
the new released permanent file tapes. Any previous copy of file RECLDB is 
replaced. 

• PRODUCT and GLOBLIB. PRODUCT contains the SYSGEN procedures used to 
install NOS and its products. GLOBLIB contains the programs and procedures used 
to recompile configuration files and install new products for the first time. 
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Step 2: Set Up Installation Tools 


The programs and procedures in GLOBLIB allow you to execute newly released 

versions of the following utilities: 

Utility Description 

ANACD Dump Analyzer Utility. Used for analyzing CDCNET access dumps. Before 
using ANACD, you must install the new version of CDCNET to disk. 

MANCC CDCNET Configuration Utility. Used for managing CDCNET configuration 
procedures. Before using MANCC, you must install the new version of 
CDCNET to disk. 

NDLP Network Definition Language Processor. Used for compiling Network 

Definition Language (NDL) files to produce a new LCFFILE and 
NCFFILE. 

NETFM Network File Manager. Used for accessing the CDCNET Network 
Directory file (NETDIR). 

NETPLM Network Procedure Library Manager. Used for maintaining libraries of 
CDCNET configuration procedure libraries. 

NPA Network Performance Analyzer. Used for analyzing CDCNET performance. 

Before using NPA, you must install the new version of CDCNET to disk. 

RCFGEN RHF Configuration File Generator. Used for compiling a new RCFMid file 
for RHF. 

SYSGEN System Generator. Used for loading permanent files from the released 
permanent file tapes and installing them on the system. 

To use the programs loaded into GLOBLIB, enter the following commands: 

ATTACH,GLOBLIB/UN=insun. 

LIBRARY.GLOBLIB/A. 
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Step 3: Update Decks and Configuration Files 


Step 3: Update Decks and Configuration Files 

During this step you will: 

• Update the deadstart decks 

• Create or update configuration files 

Do this from an interactive terminal logged in to the installation user name for most 
files. The NDL file and files belonging to CDCNET must be updated on the network 
administration user name. 

Updating the Deadstart Decks 

Modify the existing CMRDECKs and EQPDECKs. Include additional entries for any 
new products that require entries and change the CMRDECK VERSION entry to the 
new NOS release. Place the updated decks on file DSTDECK. Refer to table 3-1 and 
chapter 7 for information about each product. 

To update IPRDECKs and LIBDECKs, either add any local entries to the released 
decks or modify your local decks to include the new entries in the released decks. To 
get a copy of the released decks, first refer to Initial Deadstart Preparation in chapter 
2 to determine which released IPRDECK and LIBDECK to use. Select the decks that 
match your type of mainframe and extended memory usage. Then, get the desired 
decks from the new released deadstart tape. Add the updated decks to file DSTDECK. 
Save file DSTDECK as a permanent file for use during Step 4. 

Creating or Updating Configuration Files 

To update or create configuration files, refer to table 2-2 for a list of the products that 
require configuration file entries. Note the following: 

• If you are installing a product for the first time and the product requires 
configuration file entries, refer to chapter 7 for more first-time configuration 
information for each product. 

• Regardless of whether you need to update files LCFFILE, NCFFILE, and RCFMid, 
you must recompile these files when you upgrade the network. Refer to the NAM5 
section of chapter 7 for information about files LCFFILE and NCFFILE and to the 
RHF section of chapter 7 for information about file RCFMid. 

• If you are installing CDCNET for the first time or upgrading CDCNET, execute the 
steps in the CDCNET section of chapter 7 pertaining to your type of CDCNET 
installation. 

• Configuration files that are eventually stored on special system user names (such as 
SYSTEMX, the network operations user name, and SUBFAMO) should be 
temporarily stored on the installation user name. SYSGEN(MOVE) is used to place 
these files on the correct user names during Step 6: Install Permanent Files. Do not 
move configuration files until Step 6. 

• Configuration files that are created or updated on the network administration user 
name (for- example, NDL files, CCPLOAD files, and CDCNET configuration files) 
should be stored with temporary file names to avoid conflicts with the running 
system. 
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Step 4: Write a New Deadstart Tape 


Step 4: Write a New Deadstart Tape 

To write a new deadstart tape, use the new released deadstart tape as a base and add 
your own local deadstart decks and the binaries for any customized products. You will 
need an unlabeled scratch tape for the new deadstart tape. 

Perform the following steps from an interactive terminal logged in to the installation 
user name. 

1. If the new released deadstart tape is on local file SYSTEM, skip this step. 
Otherwise, enter the following commands: 

REQUEST,TAPE,VSN=VSn,D=dens ft y,LB=KU,F = I,PO=R. 

COPYEI.TAPE,SYSTEM,V. 

UNLOAD,TAPE. 

Replace vsn with the VSN of the released deadstart tape (contained in the media 
number field of the external tape label). Replace density with the tape density of 
the tape (HY, HD, PE, or GE). 

2. Make file DSTDECK (created in Step 3) a local file. 

3. If you did not customize binaries, place any LIBEDIT directives that are necessary 
to add your local deadstart decks to the deadstart tape on local file USERD. If no 
LIBEDIT directives are necessary, use a 0 in place of the USERD in step 4. 

If you customized binaries, place any necessary LIBEDIT directives on local file 
USERD. File USERD should contain a *FILE,DSTDECK directive to reference the 
deadstart decks in file DSTDECK. 

4. Create the new deadstart tape. 

• If you did not customize binaries, create the new deadstart tape using these 
commands: 

RETURN,NEW. 

SYSGEN,DST,SYSTEM,DSTDECK,NEW,USERD.density. 

Replace density with the density of the new deadstart tape (HY, HD, PE, or 
GE). A tape request will be issued for an unlabeled tape with VSN = NDT. The 
tape may be assigned from the system console using the following command: 

VSN,est,NDT. 

Replace est with the EST ordinal number of the tape unit where the new 
deadstart tape is mounted. LIBEDIT output is written to a local file named 
SYSLIST. 
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Step 4: Write a New Deadstart Tape 


• If you did customize deadstart binaries, create the new deadstart tape using the 
following commands. Local file USERD (if created in step 3) provides any 
necessary LIBEDIT directives. 

RETURN,NEW. 

BEGIN,GENDST,INSTALL,D=density,LIST=1ist. 

Replace density with the density of the new deadstart tape (HY, HD, PE, or 
GE). Replace list with the name of the file to receive the LIBEDIT output. A 
tape request will be issued for an unlabeled scratch tape with VSN = NDT. The 
tape may be assigned from the system console using the following command: 

VSN.est.NDT. 

Replace est with the EST ordinal number of the tape unit where the new 
deadstart tape is mounted. 
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Step 5: Override Automatic File Installation 

At this point in the installation, you have completed the following tasks: 

• Customized any other released permanent files as described in Customizing 
Permanent Files in chapter 6 (refer to Step 2). 

® Created all new configuration files and updated all existing configuration files as 
described in Step 3 of this chapter. 

Before you use SYSGEN to load permanent files (Step 6), you must first examine table 
3-1 to determine which files you do not want to load from the release tapes. The 
following files should not be loaded: 

® Files PFGDCNS and PFGCHA2, since CDCNET is installed using instructions in 
chapter 7. Do not prevent PFGCHA1 or PFGTCPH from loading; they are needed to 
update NAMSTRT. 

• Any configuration files already on your system (such as LCFFILE, LIDCMid, 
LIDVEid, NCFFILE, and NDLDATA). 

• Any files you customized when building products from source in chapter 6 (such as 
NLFFILE). 

• Any files on your system that you do not want replaced by new released versions 
(for example, subsystem startup procedures). 

Table 3-1 is organized by product name and lists the user names and file names 
associated with each product. The right column lists the PFGxxx files associated with 
each product. Make a list of all the files you do not want loaded to the new system. 

The following steps prevent files from loading by making temporary modifications to 
the RECLAIM database so that the selected PFGxxxx files appear not to be on the 
permanent file tape. That is, the file names are deleted from the database. 

After listing the files you do not want loaded to the new system, perform the following 
steps from a terminal logged in to the installation user name: 

1. Execute the RECLAIM utility by entering this command: 

RECLAIM. 

RECLAIM responds with the following prompt: 

ENTER DIRECTIVE. 

? 

2. Enter the DELETE directive to temporarily disable processing of the specified files: 

DELETE,PF=*,UN=NS2psr i n 

Replace psrin with the PSR level of the NOS release you are installing. RECLAIM 
prompts you for a list of file names: 

ENTER FILE NAMES. 

? 
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Step 5: Override Automatic File Installation 


3. Enter the desired file names: 

fi1ename1,...,fi1enamen 

Separate each file name with a comma. If it is not possible to fit all the file names 
on one line, follow the last file name with a comma and continue with more file 
names at the next prompt. After you type the last file name, enter a CR. Do not 
end the line with a period or a comma. 

RECLAIM responds with a report of the file names that have been deleted, then 
displays the following prompt: 

ENTER DIRECTIVE. 

? 

4. Terminate the RECLAIM session by entering the following: 

END 

RECLAIM responds with the following message: 

RECLAIM COMPLETE. 

Here are some additional notes on using RECLAIM: 

• You can list the names of all deleted files by executing the following command: 

RECLAIM,Z./LIST,UN=NS2psrin,DE 

• You can restore the files back to active status by executing the following command: 

RECLAIM,Z./RESET,UN=NS2psrin,PF=*/fi1ename1,...,fi1enamen 

• If you have only a few files to load, you can delete all the files from the database, 
then restore only the desired files to active status. For example: 

RECLAIM,Z./DELETE,UN=NS2psrin 

RECLAIM,Z./RESET,UN=NS2psrin,PF=*/fi1 enamel,...,fi1enamen 
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Table 3-1. Automatic File Installation 

Product Name 

User Name 

File Name 

PFGxxxx 

Name 

APL 2 

APLO 

APL1 

l 

1 

PFGAPL2 

Communications Control 
Program (CCP) 3 

netadun 3 

NLFFILE 

PFGCCPL 

Concurrent Maintenance 
Library (CML) 

CDCCE 

CML3 

PFGCML1 

Control Data Distributed 
Communications Network 
(CDCNET) 

netadun 3 

netopun 3 

insun 3 

netadun 3 

netopun 3 

1 

NETDIR 

l 

1 

NAMSTRT 2 

PFGDCNS 

PFGCHA1, 

PFGCHA2 

CYBER Database Control 
System 2 

SYSTEMX 

CDC 

PFGCDCS 

Data Catalogue 2 

Version 2.0 

LIBRARY 

l 

PFGDCL2 

Dual State 

SYSTEMX 

insun 

LIDCMid, 

LIDVEid 

VEMEM 

PFGDUAL 

Full Screen Editor 

SYSTEMX 

insun 3 

LIBRARY 

SMF 

SMFSTAT 

FSEHELP, 

FSEPROC, 

FSTEACH 

PFGFSE1 

Interactive Facility 
(IAF) 1 

SYSTEMX 

IAF, 

IAFTM, 

IAFTR 

PFGIAFl 


1. Numerous files are installed with this product. Typically, these files are handled as 
a group and are not listed here. Refer to chapter 7 and appendix B for more 
information. 


| 2. The NAMSTRT file on the network operations user name is updated by multiple 
| products. The NAMSTRT file is created by NAM and is modified by other products. 

3. insun, netopun, and netadun refer to the Control Data default values for the 
installation user name, network operations user name, and the network administration 
I user name. The default values are INSTALL, NETOPS, and NETADMN, respectively. If 
| you have changed these values, substitute your site names for the Control Data default 
| values. 

(Continued) 
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Table 3-1* Automatic File Installation (Continued) 


Product Name 

User Name 

File Name 

PFGxxxx 

Name 

Interactive Transfer 

Facility (ITF) 

o 

netopun 

NAMSTRT 2 

PFGITF1 

Maintenance Package 

SYSTEMX 

SECART, 

MSGID 

PFGTOOL 

MAP Macro Control Library 
(MMCL) V3 

SYSTEMX 

MAPLIBC, 

MAPLIBE 

PFGMMCL 

Mass Storage Extended 
(MSE) 

SYSTEMX 

SUBFAMO 

MSE, MSESLAV 
MSECONF 

PFGMSE1 

Message Control System 
(MCS) 1 

SYSTEMX 

MCS 

PFGMCS1 

MSSI V3, MAP III 

SYSTEMX 

. <i 

insun 

CDCCE 

CDCCE2 

MAPCH, 

MAPECS, 

MAPCMI 

MSSIP, 

MJOBSPL 

l 

l 

PFGMSSI 

PFGAP1I, 

PFGAP1L 

Network Access Method 
(NAM) 1 

SYSTEMX 

o 

netopun 

netadun 3 

NAM, 

NAMNOGO 

NAMSTRT 2 

LCFFILE, 

NCFFILE, 

NDLDATA 

PFGNAM5 

PFGNDL1 

NOS Online Manuals 

MANUALS 

l 

PFGMAN1 

NOS Scope Station Facility 

SYSTEMX 

SSF 

PFGNSSl 


1. Numerous files are installed with this product. Typically, these files are handled as 
a group and are thus not listed here. Refer to chapter 7 and appendix B for more 
information. 


2. The NAMSTRT file on the network operations user name is updated by multiple 
products. The NAMSTRT file is created initially by NAM and is modified by other 
products. 

3. insun, netopun, and netadun refer to the Control Data default values for the 
installation user name, network operations user name, and the network administration 
user name. The default values are INSTALL, NETOPS, and NETADMN, respectively. If 
you have changed these values, substitute your site names for the Control Data default 
values. 

( Continued) 
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Table 3-1. Automatic File Installation (Continued) 


Product Name 

User Name 

File Name 

PFGxxxx 

Name 

NOS 2 Package 

MANUALS 

l 

PFGONLM 


LIBRARY 

PFTFTR, 

RMUGET 

PFGPFTF 


LIBRARY 

TDUFILE, 

TERMLIB 

PFGTLIB 


LIBRARY 

HELPLIB 

PFGNOSB 


SYSTEMX 

RDF, 

STAGE 

PFGRDF1 

PFGNOS2 

Printer Support Utility (PSU) 

netopun 3 

EVFULFN 

NAMSTRT 5 

PFGPSU1 

PTF/QTF File Transfer 

netopun 3 

NAMSTRT 2 

PFGRHP1 

Facility 

Remote Batch Facility 

netopun 3 

NAMSTRT 2 

PFGRBF5 

(RBF) 1 

TCP/IP/FTP/TELNET 

netopun 3 

NAMSTRT 2 

PFGTCPH 

Transaction Facility (TAF) 1 

SYSTEMX 

KB100DC 

TAF 

TASKLIB 

PFGTAF1 

XEDIT 3 

LIBRARY 

XEDITH 

PFGXEDT 


1. Numerous files are installed with this product. Typically, these files are handled as 
a group and are thus not listed here. Refer to chapter 7 and appendix B for more 
information. 


2. The NAMSTRT file on the network operations user name is updated by multiple 
| products. The NAMSTRT file is created initially by NAM and is modified by other 
| products. 

| 3. insun, netopun, and netadun refer to the Control Data default values for the 

installation user name, network operations user name, and the network administration 
| user name. The default values are INSTALL, NETOPS, and NETADMN, respectively. If 
| you have changed these values, substitute your site names for the Control Data default 
values. 
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Step 6: Install Permanent Files 

Before you install the permanent files, do the following: 

• Ensure that all users have logged off the system. 

• Ensure that all normal production activity is terminated. 

• Ensure that all subsystem activity is terminated (except for the MAG and BIO 
subsystems). 

Back up the permanent files using the PFDUMP utility. You can use the backup tapes 
if you need to restore any files. Refer to the NOS Version 2 Analysis Handbook for 
information about the PFDUMP utility. 

To install new permanent files, perform the following steps from the system console. 

1. Access the new SYSGEN procedures: 

X.DIS. 

USER,SYSTEMX,password. 

GET,SYSGEN/UN=insun. 

ATTACH,GLOBLIB/UN=insun. 

LIBRARY,GLOBLIB/A. 

Replace password with the password for the SYSTEMX user name. 

2. Have your permanent file tapes available for mounting and note the VSN of the 
first permanent file tape. The VSN is in the media number field of the external 
tape label. Invoke SYSGEN by entering the following command from DIS: 

SYSGEN,FILES.vsn. 

Replace vsn with the volume serial number of the first permanent file tape. 

3. Press the period key to cause the SYSGEN procedure to begin execution. 

SYSGEN loads the files from the permanent file tapes and installs them to their 
proper user names on the system. After SYSGEN installs the files from the 
permanent file tapes, you can install the site-modified files created in Step 3. Do 
this by executing steps 4 and 5 below as many times as necessary to move all 
site-modified files. 

4. Reset the user name of your DIS package back to user name SYSTEMX: 

USER,SYSTEMX,password. 

Replace password with the password for the SYSTEMX user name. 

5. Move a file from the installation user name to its proper location by using the 
SYSGEN(MOVE) function. Refer to chapter 8 for more information about calling 
SYSGEN and SYSGEN(MOVE). 

Refer to table 3-1 to determine the proper user name for each file. If you did not 
create or modify any configuration files in Step 3, SYSGEN(MOVE) does not need 
to be executed. 
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6. If in Step 3 some files were created with temporary names (for example, the NDL 
files), change them to their correct file names. 

If you recompiled files LCFFILE and NCFFILE, follow the instructions for 
upgrading the files in the NAM5 section of chapter 7. 

If you recompiled file RCFMid, follow the instructions for upgrading the file in the 
RHF section of chapter 7. 

If you changed the default Control Data installation user names (INSTALL, 
NETOPS, and NETADMN) to ones that are site-defined, note the information given 
in Site-Defined User Names in the NAM5 section of chapter 7 

If you installed an upgrade to CDCNET, follow the instructions in Activating a 
New Level of CDCNET in the CDCNET section of chapter 7. 
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Step 7: Deadstart the New System 

Before deadstarting the new system, be sure that the corresponding level of CIP for 
this NOS release has been installed. Refer to the CIP User’s Handbook and the CIP 
SRB for more information. 

Deadstart the system using the new deadstart tape. When the system comes up, it will 
be using all of the newly released software and permanent files. The new system is 
now ready for production. If you installed an upgrade of CDCNET, you may want to 
perform the cleanup activity described in the CDCNET section of chapter 7. 

Your upgrade installation is now complete. 
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Introduction 

This chapter describes how to install additional products on a system currently running 
NOS. The PSR level of the components you want to install must be the same as that 
of the NOS software running on your system. 

A component order is an order that does not include NOS. For a component order, you 
receive a set of permanent file tapes; you do not receive a new deadstart tape. All the 
necessary binaries for your order are on the permanent file tapes. 

A component order installation consists of the steps listed below. These steps are 
described in the remaining sections of this chapter: 

1. Create New User Names 

2. Set Up Installation Tools 

3. Update Configuration Files and Decks 

4. Write a New Deadstart Tape 

5. Override Automatic File Installation 

6. Install Permanent Files 

7. Deadstart the New System 

NOTE __ 

If you have CDCNET already installed and now need to install a CDCNET separate 
TIP as part of a component order, follow the instructions given in Installing a 
CDCNET Separate TIP in the CDCNET section of chapter 7. If your Component order 
contains products in addition to a CDCNET separate TIP, you must still execute the 
instructions in chapter 4 after you have installed the TIP. 

TCP/IP/FTP/TELNET consists of a CDCNET separate TIP and host applications. For 
this reason, you should first perform the instructions given in Installing a CDCNET 
Separate TIP in the CDCNET section of chapter 7, and then perform the instructions 
in chapter 4 to install the host applications. 
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Step 1: Create New User Names 


Step 1: Create New User Names 

For each product you install, create the user names necessary to run the product. By 
creating the user names at this time, you can install files to the user name before 
deadstarting the new system. To determine the new user names, refer to table 8-1 in 
chapter 8, which lists all the user names on which the system stores files, along with 
the products that use these user names. 

| If you wish to change the default Control Data installation user names to ones that are 
| site-defined, the site user names must be created now. The user names involved are 
I the installation user name (default INSTALL), the network operations user name 
(default NETOPS), and the network administration user name (default NETADMN). 

| Please note that the user names you choose should have similar validations to the 
default values supplied by Control Data. 

| Any new user names must be created/updated from the system console using the 
MODVAL utility. Refer to the NOS Version 2 Administration Handbook for details 
| about MODVAL. 

In addition to creating the new user names, you must update your ZZSYSGU file 
(which SYSGEN uses for executing USER commands) to contain the correct user names 
and passwords for your site. Refer to SYSGEN Validations in chapter 8 for more 
1 information. 


Step 2: Set Up Installation Tools 

To set up the installation tools for the products you are installing, follow only the 
instructions that apply to the products for your site: 

• If your component order includes one of the following products, follow the 
instructions in this step titled Products Requiring Configuration Tools: 

- Control Data Distributed Communications Network (CDCNET) 

- Remote Host Facility (RHF) 

• If your component order consists of only the following products, follow the 
instructions in this step titled Permanent File Based Products: 

- Communications Control Program (CCP) 3 

- Conversion Aids Subsystems 3 

- CROSS 

- Data Catalogue 2 Version 2.0 

- Link Interface Program under CCP 3 

- NOS Online Manuals 

- 3270 TIP for CCP 

• If none of the products listed above are in your component order, follow the 
instructions in this step titled Standard Products. 

Products Requiring Configuration Tools 

If your component order includes either RHF or CDCNET, you must load configuration 
tools to the global library file GLOBLIB on the installation user name. To do so, 
perform the following steps. Before beginning, ensure that the released permanent file 
tapes are available for mounting. 

1. Log in to your installation user name on an interactive terminal. 
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Step 2: Set Up Installation Tools 


2. Access the current system to use as a base for the SYSGEN(UPGRADE) procedure: 

COMMON.SYSTEM. 

3. Execute the following command to merge the binaries on the component order tape 
with file SYSTEM: 

SYSGEN.UPGRADE,SYSTEM,NEWSYS,vsn,density. 

Replace vsn with the VSN of the CDC-supplied permanent file tape. The VSN is in 
the media number field of the external tape label. Replace density with the tape 
density of the permanent file tape (HY, HD, PE, or GE). 

This command updates the RECLAIM database, RECLDB, with information about 
the files on the permanent file tapes. The command also produces a new deadstart 
file named NEWSYS which contains all of the programs and binaries from your 
current system and those from the permanent file tapes. 

4. Place the binaries of the CDCNET and/or RHF configuration tools into your global 
library file GLOBLIB: 

RENAME.SYSTEM=NEWSYS. 

SYSGEN.INIT,SEED. 

To use the programs loaded into GLOBLIB, use the following commands: 

ATTACH.GLOBLIB. 

LIBRARY.GLOBLIB/A. 


NOTE 


Execute the instructions in chapter 6 if you wish to do either of the following tasks: 

• Customize NOS or its products 

• Change the default Control Data installation user names (INSTALL, NETOPS, and 
NETADMN) to ones defined by the site 

Pay close attention to the introductory notes in chapter 6. When you have completed 
the steps in chapter 6, continue the upgrade with Step 3: Update Configuration Files 
and Decks in this chapter. 


If you don't need to execute the instructions in chapter 6, continue with Step 3: Update 
Configuration Files and Decks in this chapter. 
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Step 2: Set Up Installation Tools 


Permanent File Based Products 

If your component order consists only of products that do not add binaries to the 
deadstart tape, perform the following steps. Before beginning, ensure that the released 
permanent file tapes are available for mounting. 

1. Log in to your installation user name using an interactive terminal. 

2. Enter this command: 

SYSGEN,UPGRADE,0,0,vsn,dens1ty. 

Replace vsn with the VSN of the CDC-supplied permanent file tape. The VSN is 
listed in the media number field of the external tape label. Replace density with 
the tape density of the permanent file tape (HY, HD, PE, or GE). 

This procedure updates the RECLAIM database, RECLDB, on your installation user 
name. 

NOTE 


Execute the instructions in chapter 6 if you wish to do either of the following tasks: 

• Customize NOS or its products 

• Change the default Control Data installation user names (INSTALL, NETOPS, and 
NETADMN) to ones defined by the site 

Pay close attention to the introductory notes in chapter 6. When you have completed 
the steps in chapter 6, continue the upgrade with Step 3: Update Configuration Files 
and Decks in this chapter. 


If you don’t need to execute the instructions in chapter 6, go to Step 5: Override 
Automatic File Installation in this chapter. 
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Step 2: Set Up Installation Tools 






Standard Products 

If your component order does not contain any of the products listed at the beginning of 
this step, perform the following steps. Before beginning, be sure the released 
permanent file tapes are available for mounting. 

1. Log in to your installation user name on an interactive terminal. 

2. Access the current system to use as a base for the SYSGEN(UPGRADE) procedure: 

COMMON,SYSTEM. 

3. Execute the following command to merge the binaries on the component order tape 
with file SYSTEM: 

SYSGEN,UPGRADE,SYSTEM,NEWSYS,vsn,dens11 y. 

Replace vsn with the VSN of the CDC-supplied permanent file tape. The VSN is in 
the media number field of the external tape label. Replace density with the tape 
density of the permanent file tape (HY, HD, PE, or GE). 

This command updates the RECLAIM database, RECLDB, with information about 
the files on the permanent file tapes. The command also produces a new deadstart 
file named NEWSYS, which contains all of the programs and binaries from your 
current system and those from the permanent file tapes. 

4. Make file SYSTEM the merged deadstart file: 

RENAME,SYSTEM=NEWSYS. 

NOTE _ 

Execute the instructions in chapter 6 if you wish to do either of the following tasks: 

• Customize NOS or its products 

• Change the default Control Data installation user names (INSTALL, NETOPS, and 
NETADMN) to ones defined by the site 

Pay close attention to the introductory notes in chapter 6. When you have completed 
the steps in chapter 6, continue the upgrade with Step 3: Update Configuration Files 
and Decks in this chapter. 


If you don’t need to execute the instructions in chapter 6, this file will be used in Step 
4 to create a new deadstart tape. 
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Step 3: Update Configuration Files and Decks 

During this step you should: 

• Update the deadstart decks. Table 2-1 lists the products that require deadstart deck 
entries. For more information about each product, refer to chapter 7. 

• Update (or create) configuration files. Table 2-2 lists products that require 
configuration file entries. For more information about each product, refer to 
chapter 7. If you are installing CDCNET for the first time or upgrading CDCNET, 
execute the steps in the CDCNET section of chapter 7 that pertain to your type of 
CDCNET installation. 

NOTE 


Configuration files that are eventually stored on special system user names (such as 
the network operations user name, SUBFAMO, and SYSTEMX) should be temporarily 
stored on the installation user name. SYSGEN(MOVE) will be used to place these files 
on the correct user names during Step 6: Install Permanent Files. Do not move 
configuration files until Step 6. 
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Step 4: Write a New Deadstart Tape 

To write a new deadstart tape, use the new file SYSTEM you created when following 
the instructions for either products requiring configuration tools or standard products in 
Step 2 of this chapter. Add your own local deadstart decks and the binaries for any 
customized products. You need an unlabeled scratch tape for the new deadstart tape. 

Perform the following steps from an interactive terminal logged in to the installation 
user name. 

1. Put the new deadstart decks on the local file DSTDECK. 

2. If you did not customize any binaries, place any LIBEDIT directives necessary to 
add your local deadstart decks to the deadstart tape on local file USERD. If no 
LIBEDIT directives are necessary, use a 0 in place of USERD in step 3. 

If you customized binaries, place any necessary LIBEDIT directives on local file 
USERD. File USERD should contain a *FILE,DSTDECK directive to reference the 
deadstart decks in file DSTDECK. 

3. Create the new deadstart tape. 

• If you did not customize any binaries, create the new deadstart tape using these 
commands: 

RETURN,NEW. 

SYSGEN,DST,SYSTEM,DSTDECK,NEW,USERD,densit y. 

Replace density with the density of the new deadstart tape (HY, HD, PE, or 
GE). A tape request will be issued for an unlabeled tape with VSN = NDT. The 
tape may be assigned from the system console using the following command: 

VSN,est,NDT. 

Replace est with the EST ordinal number of the tape unit where the new 
deadstart tape is mounted. LIBEDIT output is written to a local file named 
SYSLIST. 

• If you did customize any deadstart binaries, create the new deadstart tape using 
the following commands. Local file USERD (if created in step 2) provides any 
necessary LIBEDIT directives: 

RETURN,NEW. 

BEGIN,GENDST,INSTALL,D=density,LIST=list. 

Replace density with the density of the new deadstart tape (HY, HD, PE, or 
GE). Replace list with the name of the file to receive the LIBEDIT output. A 
tape request will be issued for an unlabeled scratch tape with VSN = NDT. The 
tape may be assigned from the system console using the following command: 

VSN,est,NDT. 

Replace est with the EST ordinal number of the tape unit where the new 
deadstart tape is mounted. 
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Step 5: Override Automatic File Installation 

At this point in the installation, you have completed the following tasks: 

• Customized any other released permanent files as described in Customizing 
Permanent Files in chapter 6 (refer to Step 2). 

• Created all new configuration files and updated all existing configuration files as 
described in Step 3 of this chapter. 

Before you use SYSGEN to load permanent files (Step 6), you must first examine table 
3-1 to determine which files you do not want to load from the release tapes. The 
following files should not be loaded: 

• Files PFGDCNS and PFGCHA2, since CDCNET is installed using instructions in 
chapter 7. Do not prevent PFGCHAl or PFGTCPH from loading, because they are 
needed to update NAMSTRT. 

• Any configuration files already on your system (such as LCFFILE, LIDCMid, 
LIDVEid, NCFFILE, and NDLDATA). 

• Any files you customized when building products from source in chapter 6 (such as 
NLFFILE). 

® Any files on your system that you do not want replaced by new released versions 
(for example, subsystem startup procedures). 

Table 3-1 is organized by product name and lists the user names and file names 
associated with each product. The right column lists the PFGxxxx files associated with 
each product. Make a list of all the files you do not want loaded to the new system. 

The following steps prevent files from loading by making temporary modifications to 
the RECLAIM database so that the selected PFGxxxx files appear not to be on the 
permanent file tape. That is, the file names are deleted from the database. 

After you list the files you do not want loaded to the new system, perform the 
following steps from a terminal logged in to the installation user name: 

1. Execute the RECLAIM utility by entering this command: 

RECLAIM. 

RECLAIM responds with the following prompt: 

ENTER DIRECTIVE. 

? 

2. Enter the DELETE directive to temporarily disable processing of the specified files: 

DELETE,PF=*,UN=NS2psr i n 

Replace psrin with the PSR level of the NOS release you are installing. RECLAIM 
prompts you for a list of file names: 

ENTER FILE NAMES. 

? 


4-8 NOS Version 2 Installation Handbook 


Revision L 






Step 5: Override Automatic File Installation 


3. Enter the desired file names: 

fllenamel,...,filenamen 

Separate each file name with a comma. If it is not possible to fit all the file names 
on one line, follow the last file name with a comma and continue with more file 
names at the next prompt. When you have typed the last file name, enter a CR. Do 
not end the line with a period or a comma. 

RECLAIM responds with a report of the file names deleted, then displays the 
following prompt: 

ENTER DIRECTIVE. 

? 

4. Terminate the RECLAIM session by entering the following: 

END 

RECLAIM responds with the following message: 

RECLAIM COMPLETE. 

Here are some additional notes on using RECLAIM: 

• You can list the names of all deleted files by executing the following command: 

RECLAIM,Z./LIST,UN=NS2psrin,DE 

• You can restore the files back to active status by executing the following command: 

RECLAIM,Z./RESET,UN=NS2psr1n,PF=*/f1lenamel.filenamen 

• If you have only a few files to load, you can delete all the files from the database, 
then restore only the desired files to active status. For example: 

RECLAIM,Z./DELETE,UN=NS2psr 1 n 

RECLAIM,Z./RESET,UN=NS2psr1n,PF=*/fi1ename1.fi1enamen 
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Step 6: Install Permanent Files 

Before you install the permanent files, do the following: 

• Ensure that all users have logged off the system. 

• Ensure that all normal production activity is terminated. 

• Ensure that all subsystem activity is terminated (except for the MAG and BIO 
subsystems). 

Back up the permanent files using the PFDUMP utility. You can use the backup tapes 
if you need to restore any files. Refer to the NOS Version 2 Analysis Handbook for 
information about the PFDUMP utility. 

Once you complete the permanent file backup, leave the system running so you can 
move the new files to their proper user names. 

Before beginning, ensure that the permanent file tapes are available for mounting and 
note the VSN of the first permanent file tape. The VSN is listed in the media number 
field of the external tape label. To install new permanent files, perform the following 
steps from the system console: 

1. Access the new SYSGEN procedure: 

X.DIS. 

USER,SYSTEMX,password. 

GET,SYSGEN/UN=insun. 

. ATTACH,GLOBLIB/UN=insun. 

LIBRARY,GLOBLIB/A. 

Replace password with the password for the SYSTEMX user name. 

2. Install unmodified permanent files by entering the following command: 

SYSGEN(FILES,vsn) 

Replace vsn with the volume serial number of the component order permanent file 
tape. 

| 3. Press the period key for execution of the SYSGEN procedure. SYSGEN loads the 
files from the permanent file tape and installs them to their proper user names on 
the system. After SYSGEN installs the files from the permanent file tape, you can 
install your site-modified files. Do this by executing steps 4 and 5 as many times 
as necessary to install all of the modified files. 

| 4. Reset the user name of your DIS package back to user name SYSTEMX: 

USER,SYSTEMX,password. 

1 5. Move a file from the installation user name to its proper location by using the 
SYSGEN(MOVE) function. This function must be called using the DSD format. 

Refer to chapter 8 for more information about calling SYSGEN and 
SYSGEN(MOVE). 
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6. If you need to set any file permissions, do so after the SYSGEN(MOVE) command 
is completed. 

If in Step 3 some files were created with temporary files (for example, the NDL 
files), change them to their correct file names. 

If you recompiled files LCFFILE and NCFFILE, follow the instructions for 
upgrading the files in the NAM5 section of chapter 7. 

If you recompiled file RCFMid, follow the instructions for upgrading the file in the 
RHF section of chapter 7. 

If you changed the default Control Data installation user names (INSTALL, 
NETOPS, and NETADMN) to ones that are site-defined, note the information given 
in Site-Defined User Names in the NAM5 section of chapter 7. 

If you did not build a new deadstart tape to install your component order, your 
installation is complete. If you wrote a new tape, continue to Step 7: Deadstart the 
New System. 

Step 7: Deadstart the New System 

Deadstart the system using the new deadstart tape. When the system comes up, it will 
be using all of the newly released software and permanent files. The new system is 
ready for production. 

Your component order installation is now complete. 
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5 


This chapter describes how to apply a critical modification set from SOLVER, a 
CDCNET Batch Critical Update (BCU), and a Dual State Batch Critical Update (BCU). 


SOLVER Modification Sets 

Applying corrective code requires you to rebuild the software you are correcting. For 
general information about building products from source code, refer to chapter 6. These 
instructions may be executed from an interactive terminal logged in to your installation 
user name. 


Using Modify for NOS and NOS Products 

When corrective code is written against NOS or the NOS products, it is written in 
standard Modify format. A Modify PSR code modset consists of the following: 

• An Ident Card. The ident card consists of the modset identifier (for a modset 
against a single deck, the identifier is the deck name followed by a sequence 
number. For a modset against more than one deck, the identifier is NS2 followed 
by a sequence number), the author’s initials, and the modset creation date. Here is 
an example: 

♦IDENT 1DS13 JDN. 85/11/13. 


• Comment Lines. A minimum of five comment lines are included with each modset, 
and these comment lines include the following information: the operating system 
identifier (PSR level), the PSR number to which the modset applies, code 
dependency information, the problem description, and the solution description. For 
example: 


♦/ 

♦/ 

*/ 

V 
»/ 

V 
•/ 

V 


»♦** NOS 2.4.2-642 OS. 

♦♦*♦ NS23316. 

♦♦♦♦ REQUIRES - NS2393(NS20749). 

*♦** PROBLEM - UNABLE TO *IDLE* A SUBSYSTEM 
IF IT IS ROLLED OUT BECAUSE THE JSN IS NOT BEING 
SAVED PRIOR TO THE *CEFM* FUNCTION. 

SOLUTION - SET THE JSN PRIOR TO CALLING *CEFM* 


In this example, the operating system identifier indicates the modset was written 
against a NOS level 642 system. This means the modset will install correctly on a 
level 642 system. The modset may or may not work on an earlier system and will 
probably be included in any system newer than 642. The REQUIRES statement 
indicates that you should also pick up modset NS2393 from SOLVER (PSR 
NS20749) since this modset depends on that earlier modset. 


• Corrective Code. The corrective code to fix the problem consists of one or more 
DECK directives (specifying the name of the deck to be modified) followed by the 
assembler or compiler statements for that deck. For example: 


♦DECK IDS 

♦I,NS2262.34 

LDD CM 

STD CM+3 


(2955) 
SET JSN 
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• Comment Line. A final comment line indicating the end of the modset. 

*/ END OF MODSET. 

Adding Corrective Code 

There are two methods you can use to add corrective code to NOS and the NOS 
products: 

1. Apply the Modify modset to OPLpsrin by using the MODOPL procedure on file 
INSTALL and then run the appropriate installation procedures. 

2. Place the corrective code on a USER file and run the appropriate installation 
procedures. 

The following examples illustrate the two methods. 

Creating a New Permanent OPL 

| The example below illustrates how to install a sample modset named 1DS13. First, use 
| the MODOPL procedure to apply the modset to OPLpsrin. This is done by using the 
| USERF parameter. 

GET,1DS13. 

BEGIN,MODOPL,INSTALL,USERF=1DS13. 

MODOPL creates a new program library named OPLpsrout that includes the change. 
Note that the USERF file may contain multiple modsets, each separated by an 
end-of-record mark. 

Next, run the affected installation procedure to generate new binaries. For example: 
BEGIN,NOS,INSTALL. 

Putting Code on a USER File 

The USER file option allows you to add corrective code to a product without installing 
the code on the output program library. The code in the USER file is added only to 
the generated binaries. 

| For example, to build NOS with PSR 1DS13, first put the code on a permanent file (in 
| this example, file 1DS13) and use the USERF parameter on the call to the NOS 
| installation procedure: 

BEGIN,NOS,INSTALL,USERF=IDS13. 
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Using Update for Common Product Set, Network Host Products, 
CCP, and CROSS 

When corrective code is written against the Common Product Set, Network Host 
Products, CCP, or CROSS, it is written in a standard Update format. An Update PSR • 
code modset consists of the following: 

• An Ident Card. The Ident card consists of the product name and, if there is a 
dependency with any other idents, a K parameter. For example: 

•ID CPS2658, K=CPS056 

The K = CPS056 indicates a code dependency. That is, CPS056 must either exist on 
the program library or precede CPS2658 in the Update input for this Ident to be 
processed. 

• History Text. The history text begins with a *B HISTORY.2 record. The HISTORY 
comments are added to the HISTORY deck, which includes a description of the 
problem, the solution, any dependencies, the author’s name, the date, decks affected 
by the product, and a *C HISTORY record. For example: 

•B HISTORY.2 

CPS2658 COMPASS/SCD. A NUMERIC DATA ITEM WITH TWO PERIODS CAUSES 

COMPASS TO HANG. CODE MODIFIES *NDS* IN *SCD* TO UPDATE 
THE COLUMN POINTER BEFORE TAKING ERROR EXIT. 

DEPENDENCY=CPS056 
AM 85/11/13 COMPASS 

•C HISTORY 

• Corrective Code. The corrective code to fix the problem consists of assembler or 
compiler statements: 

•D CPS056.1,CPS056.2 
2R 
SX6 
SA6 
BX7 
SA7 
EQ 

NDS2A SB2 B1 

•C COMPASS 

• Comment Line. The comment line indicates the total number of cards in the 
modset. 

•/ THERE ARE 20 CORRECTION CARDS INCLUDING THIS COMMENT. 

Adding Corrective Code 

There are two methods you can use to add corrective code to a product: 

1. Use Update to create a NEWPL and then build the product. 

2. Place the code on a USER file and build the product. 

The following examples illustrate each of the methods. 


(NR COMPASS.3328) 

B2.NDS2A IF FIRST *.* 

A1-CARD+1 ERROR, BUT FIRST SET CARD POINTERS 

COLUMN 

XI 

CHAR 

ERR 

SET REAL NUMBER IN FLAG 
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Creating a Permanent NEWPL 

This example illustrates how to use an Update modset, CPS2658, to fix a COMPASS 
problem. First, use an UPDATE command to add this code file and create a NEWPL: 


ATT ACH,OLOPL=CPS1psrout. 
GET.CPS2658. 

UPDATE,F,N,I=CPS2658,C=0. 


Make the NEWPL permanent and run the installation procedure for COMPASS. In 
addition, you may want to back up your release version of the program library: 

CHANGE,0CPS1PL=CPS1psrout. 

DEFINE,CPSIpsrout. 

COPYEI,NEWPL,CPS1psrout. 

RETURN,CPSIpsrout. 

BEGIN,COMPASS,INSTALL. 

Putting Code on a USER File 

The USER file option allows you to add corrective code to a product without creating a 
permanent NEWPL. The code is applied to the input PL and a temporary NEWPL, 
called NEWER, is generated. All assemblies and compilations are done using the 
compile file from NEWER. 

• Product Set and Networks. All the Common Product Set and the Network Host 
Product installation procedures give you the option of specifying a file for input 
code via the USERF parameter. 

For example, to build COMPASS with Ident CPS2658, first put the code on a 
permanent file (in this example, file CPS2658) and use the USERF parameter on 
the call to the COMPASS installation procedure: 

BEGIN,COMPASS,INSTALL,USERF =CPS2658. 

• CCP and CROSS. To add user code to CCP, the code must be on the permanent file 
UCCP for the CCPPH1, CCPBLB, and variant installation procedures. For the 
CROSS installation procedure, put the code on file UCRS. The installation 
procedures for these products automatically look for these file names. That is, you 
do not need to specify the files on the call to the installation procedures. For more 
information, refer to CCP/CROSS Permanent Files in the CCP section of chapter 7. 


5-4 NOS Version 2 Installation Handbook 


Revision L 



CDCNET Batch Critical Update (BCU) 


CDCNET Batch Critical Update (BCU) 

There are three potential types of corrections for CDCNET: a SOLVER correction to 
CHAl, a BCU to DCNS, and a problem that requires both a BCU and a SOLVER 
correction. If you are just installing a SOLVER correction to CHAl, follow the 
instructions earlier in this chapter for installing a correction to an Update product. The 
following instructions describe how to install a BCU alone and a BCU that requires a 
SOLVER correction. 

Control Data will send you a BCU tape when you require a correction to a critical 
problem with CDCNET at your site. This correction will be to the DCNS portion of 
CDCNET. The RECLAIM-formatted tape you receive will contain the file PFGBCU1 
which is installed by the procedure BCU in DCNPLIB. The installation of a BCU takes 
place on the network administration user name and should be executed from an 
interactive terminal. 

NOTE __ 

If you have changed the default Control Data installation user names (INSTALL, 
NETOPS, and NETADMN) to ones that are site-defined, the BCU installation process 
installs the files to the new user names. That is, a BCU installation retains the 
current user names; you cannot change these user names via the BCU installation 
process. 

• The following backlevel support situation is not supported: 

You have upgraded to use new user names and need to go back to a level of 
CDCNET that does not support the changing user name capability. 

• The following backlevel support situation is supported: 

You have upgraded to a level of CDCNET that supports the changing user name 
capability, you are using the Control Data default user names, and you need to go 
back to a level of CDCNET that does not support this capability. 


Preliminaries 

Before you begin these instructions, have the BCU tape available to be mounted and 
note the tape VSN and its density. (The VSN is listed in the media number field of 
the external tape label.) 

Procedure 

1. Log in to IAF under the network administration user name. 

2. Install the BCU by entering the following procedure call: 

BEGIN,BCU,DCNPLIB,vsn,density. 

Replace vsn with the VSN of the BCU tape. Replace density with the tape density 
of the BCU tape (HY, HD, PE, or GE). 

As this procedure executes, your terminal displays a message indicating the 
CDCNET version level being installed. It also displays NETFM output while the 
new boot files and object library are added to the directory. Check the NETFM 
output to ensure that all CREATE directives are completed normally. When the 
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procedure is completed, all new CDCNET software files are loaded to the network 
administration user name. Site-controlled configuration files, such as the exception 
list, are not loaded. 

3. If you are installing a SOLVER correction with a BCU, follow the directions given 
earlier in this chapter for installing a correction to an Update product. Be sure you 
use a new ID = id parameter when you invoke the CHA1 installation procedure. If 
the SOLVER modset changes any of the network utilities or servers that reside on 
the deadstart tape, you must generate a new deadstart tape. 

4. If a SOLVER correction was applied, you must use the new NETITF binaries in file 
GLOBLIB. Access these binaries by entering the following commands: 

ATTACH,GLOBLIB/UN=insun. 

LIBRARY,GLOBLIB/A. 

5. Generate a new combined message template file using the GENMSG procedure in 
DCNPLIB. Use the following procedure call and execute the procedure from the 
network administration user name: 


BEGIN,GENMSG,DCNPLIB,ID=id,P=psrout[,PURGE]. 


Parameter 

Description 

id 

The ID letter associated with the CHA1 template file name, which 
has the format HTF_id_psrout. 

psrout 

The NOS PSR level associated with the CHA1 template file name, 
which has the format HTF_id_psrout. 

PURGE 

This parameter is optional and can be specified to delete an existing 
combined template file. If you do not provide the PURGE parameter, 
GENMSG does not delete the file. 


The GENMSG procedure produces a combined template file with file name TF_id_ 
vvvv. The DCNS version level vvvv defaults to the version level of the BCU just 
installed, which causes the CDCNET template file, CTF_vvvv, to be used. For more 
information, refer to the CDCNET section in chapter 7. 

6. Activate the new software and the message template file. 

a. Activate the new software by executing the SETVL (SET_VERSION_LEVEL) 
procedure in DCNPLIB. This procedure updates file INITDCN and the exception 
list to indicate the new default versions for all CDCNET software, namely, 
ANACD, MANCC, NPA, host-connected and non-host-connected DIs, and the 
message template file. Here is the format for the SETVL procedure call: 

BEGIN,SETVL,DCNPLIB,ALL,V= vvvv, ID= id . 
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Parameter Description 

vvvv The version level of the BCU just installed. 

id The identifying letter of the combined message template file. 

For a complete discussion on the SETVL procedure and version levels, refer to 
Activating a New Level of CDCNET within the CDCNET section of chapter 7. 

Once SETVL has completed, all future load requests for DIs and all accesses for 
ANACD, MANCC, and NPA will use vvvv level software. The next initiation of 
NETOU will use template file TF_id_vvvv. 

b. Put the new message template file into use by Network Operator Utility 
(NETOU) by following the steps below: 

(1) Find the job sequence name (JSN) of NETOU on the K,NAM and K.ST 
displays (refer to the NOS Version 2 Analysis Handbook). 

(2) Enter the following command: 

DROP,jsn. 

Replace jsn with the job sequence name of NETOU. 

(3) Restart NETOU by entering the following command: 

X.NAMI(RS=OU) 

7. If a SOLVER modset was installed that corrected a problem in the CHA1 network 
servers or utilities, deadstart the system using the new deadstart tape created in 
step 3. 

The installation of the critical correction is now complete. 


Cleanup 

Once the new CDCNET version is running satisfactorily, you can remove earlier 
versions of the CDCNET software from disk to conserve space. This is done using the 
procedure CLEANUP, which purges software files from the network administration user 
name. Only files from the specified version level are removed. Boot files and object 
libraries are also removed from the network directory file, NETDIR. Execute the 
following procedure call from the network administration user name to specify the 
version level to be removed: 

BEGIN,CLEANUP,DCNPLIB,V=vvvv. 

Replace vvvv with the version level you want to remove from disk. 
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Dual State Batch Critical Update (BCU) 

A BCU for a dual state system corrects a critical problem in the dual state routines 
that reside on the NOS deadstart tape. The BCU is on a permanent file tape. This 
tape contains binaries for the deadstart tape and a permanent file. The permanent file 
(PFGBCU2) is a multifile file that has the same format as the permanent file for 
DUAL (PFGDUAL). File 1 contains the Dual State Source Library, file 2 contains the 
VEMEM procedures, and file 3 contains a RECLAIM dump of NOS/VE binary support 
for back levels of NOS. 

There are three options for installing a dual state BCU: 

1. Install the corrective code onto a NOS system that was released with your version 
of NOS/VE. This version of dual state is the official NOS/VE partner to NOS. 

2. Install the corrective code onto a version of NOS that was released prior to the 
version of NOS/VE you are using. 

3. Install the corrective code onto a NOS system that is running an older version of 
NOS/VE. For example, NOS is running at L688 and NOS/VE is running at L678. 

NOTE 


The official NOS/VE partner, and the back levels of NOS that are supported, are 
shown in the NOS/VE Software Release Bulletin (SRB). 


Correcting the Dual State Partner 

If the NOS version you are running was released with the NOS/VE version you are 
running, execute the following steps. However, before you begin, you should have the 
BCU tape available for mounting and note the density and VSN of the tape. (The VSN 
is listed in the media number field of the external tape label.) Also, you should have 
an unlabeled scratch tape available. This tape will be used for a new deadstart tape 
and will be requested with a VSN of NDT. 

Execute these commands from an interactive terminal logged in to the installation user 
name. 

1. Access the current running system by entering this command: 

COMMON,SYSTEM. 

2. Execute SYSGEN: 

SYSGEN.UPGRADE,SYSTEM,NEW,vsn,densit y1,dens11 y2. 

Replace vsn with the VSN of the BCU tape. Replace densityi with the tape density 
of the BCU tape. Replace density2 with the tape density of the new deadstart tape. 

The procedure first requests the BCU tape. After the BCU tape is processed, the 
procedure requests the unlabeled scratch tape and writes the new system to this 
tape. 
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Correcting an Earlier Version of NOS 

If the NOS version you are running was released prior to the NOS/VE version that 
you are running, execute the following steps. Before you begin, you should have the 
BCU tape available for mounting and note the density and the VSN of the tape. (The 
VSN is listed in the media field of the external tape label.) Also, you should have an 
unlabeled scratch tape available. This tape will be used for a new deadstart tape and 
will be requested with a VSN of NDT. 

1. Log in to your installation user name using an interactive terminal. 

To properly install a BCU, you need the SYSGEN procedures that match the PSR 
level of NOS/VE. This means you need the procedure SYSGEN and the user library 
PFGLIB available. If you do not have these on your catalog, they may be GTRd 
from the released NOS deadstart tape. The local file names must be SYSGEN and 
PFG, respectively. 

The level of software in the RECLDB file must also match the PSR level of 
NOS/VE. You can check this by cataloging the RECLDB file. Record 1 shows the 
user name known to RECLAIM (for example, NS2psrin). If the user name does not 
contain the correct PSR level, you must change the name of the RECLDB file to 
something else. After installing the BCU, delete the newly created RECLDB and 
change the old name back to RECLDB. 

2. Enter this command: 

SYSGEN,UPGRADE,0,0,vsn,density. 

Replace vsn with the VSN of the CDC-supplied BCU permanent file tape. Replace 
density with the tape density of the BCU permanent file tape (HY, HD, PE, or 
GE): 

This command updates the RECLAIM data base to contain information about all of 
the files on the BCU permanent file tape. 

3. To obtain the corrected dual state binaries from the BCU tape, enter the following 
command: 

SYSGEN,DUAL,OLDNOS,BCU. 

This command creates or replaces files with the naming convention NVEoldlev, 
where oldlev is the PSR level of NOS for which the binaries were compiled. 

4. To apply these binaries to your production system and create a new deadstart tape, 
use the following commands: 

COMMON,SYSTEM. 

ATTACH,NVEoldlev. 

SYSGEN,DST,SYSTEM,NVEo1d1ev,NEW,0,dens11 y. 

Replace oldlev with the NOS level you are running and replace density with the 
tape density of the new deadstart tape. 
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$ 

| Correcting an Older Version of NOS/VE 

| In this situation, you are running a new NOS system with an older version of 
I NOS/VE. For example, NOS is running at L688 and NOS/VE is running at L678. You 
1 have received a BCU tape for -the level of NOS/VE you are running. 

To install this BCU, you need to build new binaries for the dual state combination you 
I are running from the source available on the BCU tape. 

| Follow the instructions in Dual State Upgrade of NOS Only in the DUAL section of 
| chapter 7. 
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Introduction 

This chapter describes how to customize the binaries for products that reside on the 

deadstart tape as well as how to customize the released permanent files. Note that 

customization is performed as part of one of the installations described in chapters 2, 

3, 4, and 5 of this handbook. This chapter contains the following sections: 

• Customizing Deadstart Tape Binaries 

• Customizing Permanent Files 

Before you begin the steps in this chapter, note the following: 

• Make a list of the products you want to customize. Next, check the product 
dependency charts (figures 6-1 through 6-3) for other products that are dependent on 
the products you want to customize and add these to the list. These are the 
products you must rebuild. 

• Refer to chapter 7 for special information about each product you are installing. 

• Special installation parameters, procedures, and commands relating to DECKOPL 
are described in chapter 9. 

• Instructions for loading individual files (for example, the PSR report or DECKOPL) 
are described in chapter 8. 

• If you are doing a component installation and your order contains a Modify product 
that resides on the composite OPL, you must update your existing composite OPL 
before customizing any products. Use the SYSGEN(RECLAIM) command to load file 
OPLpsrin from the component order permanent file tapes. This file must be 
LIBEDITed against your previous composite OPL. 

® Special information about installing a 63-character set system is detailed in 
appendix C. Read this appendix before you begin installing your system. 

® You must decide where you want to store source files during the installation 

process. You can either let the installation decks load files automatically from the 
permanent file tapes or you can preload the files to disk. If you let the installation 
decks automatically load the required permanent files, you can make the files 
disk-resident or you can use local files during the installation procedures. Note that 
some source files must be disk-resident - for example, the composite OPL and 
numerous CCP build files. Once you load the source installation tools, you can set 
up files for disk installation. Refer to Disk Installations in chapter 9 for information 
about controlling the permanent file environment. 

• If all network-related products are ordered, the installation user name may require 
unlimited indirect access file validations because the size of NAMSTRT will exceed 
the default indirect access file size.. 

• If you wish to run a newer version of NOS with an older version of NOS/VE (for 
example, NOS L688 with NOS/VE L678), the dual state binaries must be 
reassembled. Refer to Dual State Upgrade of NOS Only in the DUAL section of 
chapter 7. 
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Customizing Deadstart Tape Binaries 

Step 1: Load the Installation Tools and Files 

If you are customizing as part of a first-time, component, or corrective installation, 
only perform step 1 below. If you are customizing as part of an upgrade installation, 
only perform step 2 below. 

1. Have the released permanent file tapes available for mounting and execute the 
following command from an interactive terminal logged in to the installation user 
name: 

SYSGEN(SOURCE,CCP) 

Include the keyword CCP only if you want to load CCP/CROSS binary installation 
files. Refer to chapter 7 for more information about CCP installation. 

NOTE 


If the source build procedures for the current level of NOS are already on the 
installation user name, skip this step. 


2. Have the released permanent file tapes available for mounting and execute the 
following command from an interactive terminal logged in to the installation user 
name: 

PURGE.RECLDB/NA. 

GTR,SYSTEM,PFG.ULIB/PFGLIB 
BEGIN,SYSGEN,SYSTEM,SOURCE,CCP. 

Include the keyword CCP only if you want to load CCP/CROSS binary installation 
files. Refer to chapter 7 for more information about CCP installation. 

If you will be running the SEED procedure in the same terminal session (see Step 
4), do not RETURN file SYSTEM. Keep file SYSTEM as a local file to avoid an 
additional tape request in Step 4. 

The procedures in steps 1 or 2 above load the RECLAIM database (RECLDB), 
DECKOPL, INSTALL, CODEPL, MISCPL (if released), NOS PSR report file (PSRRPT), 
USERBPS, NAMSTRT (if appropriate), and COMMOD and make RECLAIM a 
permanent file. Refer to chapter 8 for a complete list of files. 
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Step 2: Customize the Installation Procedures 

You build products by executing installation procedures on the INSTALL procedure file. 
To customize the installation procedures on the INSTALL file, follow these steps: 

NOTE _ 

If you want to install a 63-character set system, read appendix C before continuing 
your installation. 


1. You may want to print a DECKOPL listing by using the DECKLIS procedure. (This 
listing is over 400 pages.) For information about additional DECKLIS parameters, 
refer to chapter 9. 

BEGIN,DECKLIS,INSTALL. 

2. Edit file COMMOD using an available editor. File COMMOD is a correction set 
containing parameters that control the following: 

• Whether installation is from tape or disk. 

• Where files reside for a disk installation. 

• USER and CHARGE commands used for executing installation procedures. 

• Whether USER files are searched for automatically. 

• Different values for other common parameters. For example, parameters that 
specify what job output listings to create, parameters that determine whether job 
output should be printed, parameters that specify the tape density for tape 
requests, parameters that determine whether output PLs are written, and a 
parameter that determines the type of load map that is generated. 

Refer to COMMOD File Parameters in chapter 9 for a list of the parameters you 
can change. 

3. Locate the parameters you want to change, and specify the values you want for the 
parameters. When you finish, replace file COMMOD. 

4. When customizing some products (for example, CHA1), files are created on the 
installation user name. In general, these files are private; however, some of them 
are used during the installation process. The PERMIT procedure in DECKOPL 
permits these files to the appropriate user names. If you change the default Control 
Data installation user names (INSTALL, NETOPS, and NETADMN), PERMIT needs 
to be updated to reflect the site's user names. For example, PERMIT uses the 
following IF test to permit NLFFILE: 

.IF, $SYMFN$ .EQ. $NLFFILE$,PERMIT3. 

PERMIT(REALFN,NETOPS=R) 

.ENDIF.PERMIT3. 

When NLFFILE is created, the following statement calls the PERMIT procedure: 
BEGIN(PERMIT,INSTALL,REALFN=G_GN_CL,SYMFN=NLFFILE) 
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A site can add a PERMIT call to any installation procedure that creates permanent 
files. A matching IF test must be added to the PERMIT procedure. These changes 
should be added to file COMMOD so that when SETUP is run in the following step, 
the INSTALL file is created with the desired changes. 

5. Recreate the INSTALL file to include the new parameter values by entering this 
command: 

BEGIN,SETUP,INSTALL,MOD=COMMOD,INSTALL. 
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Step 3: Create USER Files 

To further customize products during installation, you can create USER files (files 
containing modified code for each product you want to customize). (User code for the 
composite OPL is discussed in Step 5.) Each file can contain the following: 

• Programming Systems Report (PSR) corrective code from SOLVER. Refer to chapter 
5 for information about SOLVER code. 

• MISCPL code (refer to the MISCGET procedure in chapter 9). 

• Product installation parameter settings (for specific parameters for a product, refer 
to that product entry in chapter 7). 

• Site code. 

Refer to chapter 7 and the Software Release Bulletin (SRB) for special information 
about each product you are installing. 

When you create a USER file that contains modifications for a product, these 
modifications must be in the same format as the product you are modifying, either 
Modify or Update. NOS, NOS products, PFTF, and APL 2 are in Modify format. All 
other products are in Update format. 
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USERF Parameter 

When an installation job is executing, it expects to find your modifications on a local 
file named USER. However, if you do not want to make your modification file local to 
the installation procedure, you can use the USERF parameter. The USERF parameter 
should be controlled from COMMOD (refer to Step 2: Customize the Installation 
Procedures in this chapter and COMMOD File Parameters in chapter 9). 

• If USERF is null (the default value), a USER file is looked for only if a file name 
is specified on the call to the installation procedure. For example: 

BEGIN,AAM2,INSTALL,USERF=USERAAM. 

In this case, the installation procedure looks for a permanent file named 
USERAAM. If it does not find the file, the procedure aborts. If USERF = UJOBNAM 
is specified on the procedure call, it overrides the null value. 

• If USERF is equal to UJOBNAM, a USER file is looked for automatically. If a 
permanent file with the name U concatenated with the first six characters of the 
installation procedure name is found, the user code is applied. If no permanent file 
of that name is found, the procedure executes as usual and no user code is applied. 
For example: 

BEGIN t AAM2 f INSTALL. (looks for a file named UAAM2) 

BEGIN,BINEDIT,INSTALL. (looks for a file named UBINEDI) 

If USER=filename is specified, it overrides the UJOBNAM value. 

NOTE 


If you create a USER file to add site modifications, the code is not installed on the 
output program library. This code is applied last and is added only to the generated 
binaries. If you need this program library as input for another product installation, all 
the code is not present and problems could result. To avoid this, manually create a 
new program library that contains the user code using Modify or Update. 
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Step 4: Create Files GLOBLIB and PRODUCT 

The SEED procedure creates three files: PRODUCT, DIRFILE, and GLOBLIB. The 
binaries in PRODUCT and GLOBLIB are used to satisfy all dependencies for the start 
of a full installation, as well as dependencies for a partial installation. DIRFILE is 
used to keep track of all the binaries in file PRODUCT. 

The SEED procedure does the following: 

• Places necessary user libraries on file PRODUCT. 

• Places the following types of binaries on GLOBLIB: 

- Compilation, assembly, and loader tools 

- System text definition binaries 

- Configuration tools 

To execute the SEED procedure, you must have a copy of the released system: 

• If you are performing a first-time, component, or corrective installation, specify 
DST = SYSTEM on the SEED call to use the running system for initializing 
PRODUCT and GLOBLIB. 

• If you are performing an upgrade installation, specify DST = SYSTEM on the SEED 
call to use the local file SYSTEM created in Step 1. If file SYSTEM is not local, 
REQUEST the released deadstart tape and COPY it to a file named SYSTEM. Then 
specify DST=SYSTEM on the SEED call. 

NOTE 


The SEED procedure assumes the Maintenance Package, which contains SYMPL, was 
ordered. Without SYMPL, the SEED procedure will abort. If you want to rebuild a 
product that does not require SYMPL and you did not order the Maintenance Package, 
execute the NOEXIT command before running the SEED procedure. After SEED is 
completed, type in ONEXIT. 
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Here is the format for the SEED call: 

BEGIN,SEED,INSTALL,paraml.....paramn 

Parameter Description 

DST=dstname Local file name for your copy of the system. If file dstname is not a 
mass storage file, dstname is copied to a mass storage file before the 
GTR commands in the SEED procedure extract the required binaries. 
If DST = SYSTEM and no file named SYSTEM is local or on disk, 
SEED performs a COMMON(SYSTEM) command for you. 

NOREBLD The keyword parameter NOREBLD causes SEED to load only a 

minimal set of binaries into GLOBLIB and PRODUCT. NOREBLD 
should be specified ONLY if ALL products will be rebuilt, for 
example, if converting to the 63-character set. 

RESET The keyword parameter RESET causes SEED to initialize the files 

JOBSTAT and DAYFILS; these files keep statistics on the installation 
procedures and dayfiles. To get a report of the resource usage of your 
installation procedures and a list of what procedures have passed or 
failed, refer to the REPORT procedure in chapter 9. 
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Step 5: Execute the MODOPL Procedure 

Use the MODOPL procedure to apply code (for example, to modify installation 
parameters) against the composite output program library (OPL). The OPL contains all 
Modify-formatted products except APL 2 and PFTF. 

If you do not want to write a new OPL - that is, you are not applying any 
modifications to the composite OPL and are not changing the value of psrout (see 
COMMOD File Parameters in chapter 9) - you do not need to execute MODOPL. The 
OPL will be automatically loaded from tape when it is needed. 

If you change psrout or will be applying code, you must execute MODOPL. If you 
execute MODOPL, it creates disk file OPLpsrout (psrout defaults to the current release 
level). If DISKIN3 = NO, MODOPL also writes a copy to tape. 

MODOPL always writes the updated program library to a permanent file named 
OPLpsrout. The common deck COMXOPL in DECKOPL defines its residency. 
OPLpsrout is used as an auxiliary PL by many installation procedures. The operating 
system installation procedures use it to generate the compile file for operating system 
installations. 

To apply code against the composite OPL, create a USER file. This file may include 
any of the following items: 

• Miscellaneous code (optional) from MISCPL (refer to the MISCGET procedure in 
chapter 9). 

• Modifications of the NOS installation parameters (refer to chapter 7). 

• Modifications to operating system products (refer to chapter 7). 

• Site code. 

When MODOPL executes, it expects to find your modifications on a local file named 
USER. However, if you do not want to make your modification file local to the 
installation procedure, you can use the USERF parameter. The USERF parameter 
should be controlled from COMMOD (refer to Step 2: Customize the Installation 
Procedures in this chapter and COMMOD File Parameters in chapter 9). 

• If USERF is null (the default value), a USER file is looked for only if a file name 
is specified on the call to the installation procedure. For example: 

BEGIN,MODOPL,INSTALL,U$ERF=NOSMODS. 

In this case, MODOPL looks for a permanent file named NOSMODS. If it does not 
find the file, MODOPL aborts. If USERF = UJOBNAM is specified on the procedure 
call, it overrides the null value. 
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• If USERF is equal to UJOBNAM, a USER file named UMODOPL is looked for 
automatically. If file UMODOPL is found, the user code is applied. If no file of that 
name is found, MODOPL executes as usual and no user code is applied. For 
example: 

BEGIN,MODOPL,INSTALL, (looks for a file named UMODOPL) 


If USERF=filename is specified, it overrides the UJOBNAM value. 

Note that you can only permanently apply the code on file USER (or the file specified 
with the USERF parameter) to the composite OPL by using the MODOPL procedure. 
For all other installation procedures, USER code affects only the binaries and not the 
new OPL. 

If you are only changing the value of psrout and are not applying code, you can 
execute MODOPL by using this command: 

BEGIN,MODOPL.INSTALL. 
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Step 6: Build Products from Source Code 

To build products from source, you need to determine the related installation 
procedures, the dependencies they may have, and if there are any unique parameters. 
The following pages contain this information. 

Refer to table 6-1 to make a list of associated installation procedures for the products 
you plan to modify. 

NOTE 


If you are changing the default Control Data installation user names (INSTALL, 
NETOPS, and NETADMN) to ones that are site-defined, note the following: 

• You must rebuild SYSGEN and provide the site user names. For example: 

BEGIN,SYSGEN,INSTALL,insun,netopun,netadun. 

This changes PFGLIB so that files are permitted to the correct user names during 
execution of SYSGEN. Since SYSGEN checks the installation user name first for 
PFGLIB, the correct one will be used. 

• There are 3 installation parameters in CHA1 that reference user names NETOPS 
and NETADMN (refer to Installation Parameters in the CDCNET section of chapter 
7). It is recommended that these parameters be changed to match the user names 
desired by the site and that CHA1 be reassembled. 
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Table 6-1. OIP Options and Associated Installation Procedures 
Product Name Related Installation Procedures 


APL 2 
BASIC 3 
COBOL 5 

Communications Control Program (CCP) 3 
Concurrent Maintenance Library (CML) 

Control Data Distributed Communication 
Network (CDCNET) 

Conversion Aids Subsystem 3 

CYBER CROSS System 1 

CYBER Database Control System 2 

CYBER Interactive Debug 

Data Catalog 2 Version 2.0 

Data Description Language 

FORTRAN Database Facility 1 

FORTRAN Extended 4 

FORTRAN Extended 4 with Interactive 
Option 

FORTRAN 5 

FTN 4/5 Conversion Aid 1 
Full Screen Editor 
High Speed I/O Package 


APL2 

BASIC3 

COBOL5/COBOL5Q, FCL1, FCL2, PMD 

CCPPH1, CCPBLB, CCPVAR, CCPLOAD 

No installation procedure. Consult the 
Concurrent Maintenance Library Reference 
Manual. 

CHA1 

LCS3, FCS3 

CROSS 

CDCS2 

CID 

DCL 

DDL3 

FDBF 

FTN4, FCL1, FCL2, PMD 
FTNTS, FCL1, FCL2, PMD 

FTN5, FCL5, PMD, CCG 

F45 

FSE 

HSIO _ 

(Continued) 
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Table 6-1. OIP Options and Associated Installation Procedures (Continued) 
Product Name Related Installation Procedures 


Interactive Facility 1 

Interactive Transfer Facility 

Link Interface Program under CCP 3 

Maintenance Package 

Mass Storage Extended 

Message Control System 1 

MMCL V3, MAP Macro Control Library 

MSSI V3, MAP III 

Multi-Mainframe Module 1 

Network Access Method 1 

NOS Online Manuals 

NOS Scope 2 Station 

NOS 2 Package 

PASCAL 170 
Printer Support Utility 
PTF/QTF File Transfer Facilities 
Query/Update 3 
Remote Batch Facility 1 
Remote Host Facility 
Sort/Merge 5 
TCP/IP/FTP/TELNET 
Tracer 1 

Transaction Facility 1 
Xedit 3 

3270 TIP for CCP 


IAF 

ITF, RHC 
(Part of CCP 3) 

TOOLS, CEDIAG, FORMAT, SYMPL 

MSE 

MCS 

MMCL 

MSSI, AP1I, AP1L 
MMF 

NAM5/NAM5D 
No installation procedure. 

NSS 

AAM2, BAM, BINEDIT, BIT8, CCL, 
COMPASS, FORM, LOADER, NIP5870, 
NOS, NOS2B, OSLIB, OSTEXT, PFTF, 
RDFEX, SYSGEN, TDU, TERMLIB, 
TEXT, TEXTIO, UPDATE 

PASCAL 

PSU 

RHP, RHC 
QU3 

RBF5/RBF5D 

RHF, RHC 

SORT5 

TCPH 

TRACER 

TAF 

XEDIT 

(Part of CCP 3) 
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Some installation procedures require the output of another installation procedure. These 
procedures are dependent on other procedures; that is, they cannot be run until the 
procedure they depend on is completed. Figures 6-1, 6-2, and 6-3 illustrate the 
installation procedure dependencies. 

Based on whether a procedure is dependent on another, the procedures have been 
separated into groups. Run the procedures in the order described. 

NOTE 


If a product has two possible installation procedures, the procedures for the product are 
enclosed in one box in the Build Dependencies Charts (figures 6-1, 6-2, and 6-3). Run 
only one procedure for each product. 


Run Group 1 

Run the group 1 procedures listed in table 6-2 in the order in which they are shown in 
figure 6-1. Do not run a procedure until the preceding procedure has finished. 

Run Group 2 

Run the group 2 procedures listed in table 6-3 after running all the procedures in 
group 1. You can run the group 2 procedures in any order you want and more than 
one procedure can be run simultaneously. (See figure 6-2.) 

Run Group 3 

Run the group 3 procedures listed in table 6-4 after all the procedures in group 1. 
Group 3 procedures must be run in the order shown in figure 6-2. 

Run Group 4 

Run the group 4 procedures listed in table 6-5 after all the procedures in group 1. 
Group 4 procedures must be run in the order shown in figure 6-3. 

Run Group 5 

Run the group 5 procedures listed in table 6-6 after all the procedures in group 1 and 
after the AAM2 procedure from group 3. Group 5 procedures must be run in the order 
shown in figure 6-3. 

Run Group 6 

| Run the group 6 procedure listed in table 6-7 after the NAM5 procedure from group 5 
I and after the FTN5 procedure from group 4. 
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Figure 6-1. Build Dependencies Chart (Group 1) 
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GROUP 2 (Run after Group 1 in any order) 


CCL 


FSE 


NIP5870 


NSS 


LCS3 


FCS3 


MSE 


APL2 


TRACER 


PFTF * 


GROUP 3 (Run after Group 1) 



^64-Character Set Only 


Figure 6-2. Build Dependencies Chart (Groups 2 and 3) 
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GROUP 4 (Run after Group 1) 



GROUP 5 (Run after Group 1 and AAM2 from Group 3) 



GROUP 6 (Run after FTN5 from Group 4 and NAM5 from Group 5) 


PSU 


*64 - Character Set Only 


Figure 6-3. Build Dependencies Chart (Groups 4, 5, and 6) 
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Customizing Deadstart Tape Binaries 


If you modify a product that affects another product, you may need to add the other 
product’s installation procedure to your list. Use the dependencies charts (figures 6-1, 
6-2, and 6-3) to determine which installation procedures to run. If you are still unsure 
whether the modification you want to make will affect another product, refer to the 
installation procedures in DECKOPL. 

The basic format for executing an installation procedure from the INSTALL file is the 
following: 

BEGIN,pr ocname, INSTALL , p1 . pn . 

Replace procname with the installation procedure name. The optional parameters (pi 
through p n ) include two types of parameters: common and unique. 

Common parameters are explained in the COMMOD File Parameters section of 
chapter 9. Tables 6-2 through 6-7 list the unique parameters and required files for 
each installation procedure. Special information, such as unique parameters, is 
provided in chapter 7. 


Table 6-2. Group 1 Products 


Procedure Name 

Unique Keywords 

Required Files 

MODOPL 


OPLpsrin 

TEXT 

MFT=mft, 

ECS=ecs, 

CSET=cset 

TEXTpsrin 

TEXTIO 


TXIOpsrin 

COMPASS 


CPSlpsrin 

UPDATE 


UPDlpsrin 

CPSlpsrout 

OSTEXT 


OPLpsrout 

CCG 


CCGlpsrin 

RHC 


RHClpsrin 

BINEDIT 


BINEpsrin 

CPSlpsrout 

FCL1 


FCL4psrin 

CPSlpsrout 

LOADER 

PRESET = value, 

MAP=map, 
FLMSG=flmsg 

LDRlpsrin 

FORMAT 


FMATpsrin 

OPLpsrout 


(Continued) 
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Table 6-2. Group 1 Products (Continued) 


Procedure Name 

Unique Keywords 

Required Files 

MMF 


OPLpsrout 

HSIO 


OPLpsrout 

XEDIT 


OPLpsrout 

NOS 


OPLpsrout 

FTN4 


FTN4psrin 

CPSlpsrout 

FTNTS 


FTI4psrin 

CPSlpsrout 

SYMPL 


SYMPpsrin 

PASCAL 


PASCpsrin 

OPLpsrout 

BASIC3 


BAS3psrin 

CPSlpsrout 

OPLpsrout 

BAM 


BAMlpsrin 

TEXTpsrout 

FCL5 


FCL5psrin 

CPSlpsrout 

SORT5 


SRT5psrin 

OSLIB 


OPLpsrout 

FCL2 


FCL4psrin 

CPSlpsrout 

BIT8 


BIT8psrin 

CID 


CIDlpsrin 

OPLpsrout 

PMD 


PMD5psrin 

CPSlpsrout 

F45 


F451psrin 

CPSlpsrout 

TDU 1 


TDUlpsrin 

OPLpsrout 

TERMLIB 

TERMCAP = termcap 

OPLpsrout 

FORM 


FORMpsrin 

1. 64-character set only. 
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Table 6-3. Group 2 Products 


Procedure Name 

Unique Keywords 

Required Files 

CCL 


CCLlpsrin 

CPSlpsrout 

OPLpsrout 

FSE 


OPLpsrout 

NIP5870 


OPLpsrout 

NSS 


NSSlpsrin 

OPLpsrout 

LCS3 


LCS3psrin 

FCS3 


FCS3psrin 

MSE 

SAVELIB 

OPLpsrout 

APL2 

TERMTYP = termtyp 

APL2psrin 

OPLpsrout 

TRACER 


OPLpsrout 

PFTF 1 


PFTFpsrin 

TDUlpsrin 

OPLpsrout 

1. 64-character set only. 
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Table 6-4. Group 3 Products 


Procedure Name 

Unique Keywords 

Required Files 

AAM2 


AAM2psrin 

DDL3 


DDL3psrin 



CPSlpsrout 

FDBF 

FTN4 

FDBFpsrin 

CPSlpsrout 

DDL3psrout 

CDCS2 

DEBUG 

CDCSpsrin 

AAM2psrout 

DDL3psrout 

OPLpsrout 

CPSlpsrout 

COBOL5 

NOTAF, NOCDCS 

COB5psrin 

COBOL5Q 

NOTAF, NOCDCS 

COB5psrin 

DCL 


DCL2psrin 

QU3 


QU31psrin 

DDL3psrout 

OPLpsrout 
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Table 6-5. Group 4 Products 

Procedure Name 

Unique Keywords 

Required Files 

FTN5 


FTN5psrin 

CPSlpsrout 

CCGlpsrout 

MSSI 

BLDMLIB, 

MSSIpsrin 


MSAMLIB 

OPLpsrout 

AP1I 

MEMSIZE 

APlIpsrin 

MMCL 


MMCLpsrin 

AP1L 

MAPTYP, ADD, MUL, 
DIV, SQRT 

MMCLpsrin 

CEDIAG 


CEDGpsrin 

OPLpsrout 

TOOLS 


OPLpsrout 

NOS2B 


OPLpsrout 

SYSGEN 

INSUN = insun, 
NETOPUN = netopun, 
NETADUN = netadun 


CML 1 




1. Consult the Concurrent Maintenance Library Reference manual for installation 
information. 
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Table 6-6. Group 5 Products 


Procedure Name 

Unique Keywords 

Required Files 

RHF 


RHFlpsrin 

RHClpsrout 

OPLpsrout 

ITF 

NOTRACE 

ITFlpsrin 

RHClpsrout 

OPLpsrout 

RHP 

SUBSYS=subsys, 

RHPlpsrin 


TRACE, DEBUG 

RHClpsrout 

OPLpsrout 

NAM5 

NOTRACE 

NAM5psrin 

OPLpsrout 

NAM5D 


NAM5psrin 

OPLpsrout 

IAF 


OPLpsrout 

RBF5 

NOTRACE 

RBF5psrin 

NAM5psrout 

OPLpsrout 

RBF5D 

• 

RBF5psrin 

NAM5psrout 

OPLpsrout 

RDFEX 


OPLpsrout 

MCS 

TRACE 

MCSlpsrin 

NAM5psrout 

OPLpsrout 

TAF 

DEBUG, NOLOG, 
TASKLB 

OPLpsrout 

DUAL 

TRACE 

DUALpsrin 


NOSLEV=noslev, 

OPLpsrout 


VELEV=velev, 

TDUlpsrin 


CSET=cset 

BAMlpsrout 

CHA1 1 

DEBUG, NOTRACE, 

CHAlpsrin 


ID = id 

NAM5psrout 

OPLpsrout 

1. 64-character set only. 


( Continued) 
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Table 6-6. Group 5 Products (Continued) 


Procedure Name 

Unique Keywords 

Required Files 

TCPH 1 

DEBUG, NOTRACE 

TCPHpsrin 

NAM5psrout 

OPLpsrout 

CROSS 


CRSSpsrin 

CCPPH1 

DIAG, REMT, BSTP, 
XTRAPLS 

CCPBpsrin 

CCPTpsrin 

CCPRpsrin 

CCPDpsrin 

CCPBLB 

XREF 


CCPVAR 

VN = vn 


CCPLOAD 

GN = gn 



1. 64-character set only. 


Table 6-7. Group 6 Products 

Procedure Name Unique Keywords 

Required Files 

PSU NOTRACE 

PSUlpsrin 


OPLpsrout 
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Step 7: Create a New Deadstart Tape 

After you have completed building products customized for your site, create a new 
deadstart tape by entering this command from an interactive terminal logged in to the 
installation user name: 

BEGIN(GENDST,INSTALL,SY$TEM=odt t NEW^ndt,D=density,LIST=list) 

This command merges the binaries in file PRODUCT with the current system or 
another deadstart tape to produce a new deadstart tape. Refer to chapter 9 for more 
information about GENDST. 

If you are building on a system with limited disk space, execute GENDST followed by 
RESETP to reduce the size of file PRODUCT. Refer to chapter 9 for information 
about the RESETP procedure. 

If you are customizing a product as part of a component installation, use the 
deadstart file created in Step 2 of chapter 4 for the SYSTEM parameter. This tape 
contains the released binaries from the component order tape and ensures that the 
binaries are placed in the proper order. 

NOTE _ 

A deadstart file must fit onto a single reel of tape. If your deadstart file is on more 
than one tape, you will not be able to deadstart using the tapes. You should rebuild 
the tape using a higher tape density or a longer tape. 

If your deadstart file still extends past the single reel limit, remove some binaries 
from the tape. Do not remove any of the first five libraries. Place the removed 
binaries on a permanent file and SYSEDIT this file after deadstart. You may want to 
put this SYSEDIT file into SYSPROC, which is always called after deadstart. Refer to 
the NOS Version 2 Analysis Handbook for information about SYSEDIT. 
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Customizing Permanent Files 

In addition to the deadstart tape binaries, NOS uses permanent files to control the 
execution of subsystems, provide interactive help for commands, and provide 
information that describes the software and hardware configuration of peripheral 
equipment. This section describes how to customize the permanent files. 

Modify the permanent files on the installation user name by using one of these 
methods: 

• Apply user code during the build process (this is described in Step 3 and Step 5 
of this chapter). 

• Modify the permanent files after they are generated in the build process. The files 
can be modified using an available editor. 

• Load the permanent files to disk from the permanent file tape and then modify 
the files. Chapter 8 describes how to load individual permanent files from the 
permanent file tapes using SYSGEN(RECLAIM). You can also call a SYSGEN 
function to load a file from the tape and break it into its component pieces. For 
example, SYSGEN(MSEl) loads file PFGMSE1 from the tape and creates files 
MSESLAV, MSE, and MSECONF. 

Table 3-1 in chapter 3 (which shows files you can prevent from loading) and appendix 
B (which lists the names of all PFG files and their associated function names) can be 
used to determine permanent file names and SYSGEN function names. 

Once the files have been modified, they must be moved to the proper user names on 
the system as described in chapter 3 or 4. To avoid overwriting current system files, 
do not move these files until directed to do so. For a first-time installation, refer to 
SYSGEN(MOVE) in chapter 8 for information about moving permanent files. 
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This chapter describes subsystem initiation and provides special information for 
customizing and configuring NOS and its products. The products are listed in 
alphabetical order according to the installation procedure name. If special information 
about a product does not exist, the product installation procedure is not listed. 


Subsystem Initiation 

Subsystem Startup Files 

When you install a subsystem, make sure there is a startup procedure file for 
initiating the subsystem. (Table 7-1 lists all the subsystems.) Startup files must be 
stored as indirect access files on user name SYSTEMX. They must also be named 
using the following format: 

subffff 

Parameter Description 

sub The 3-character name for the subsystem (for example, NAM). 

ffff An optional 0- to 4-character extension to the name (for example, 

CLSH). 

DECKOPL installation procedures create startup procedures for all subsystems and 
place them as indirect access files on the installation user name. The files are named 
with the appropriate 3-character subsystem name. SYSGEN places the released versions 
of all subsystem startup procedures on the system user name SYSTEMX. The files are 
private with read permission given to the installation user name. If you modify the 
procedures, you can use the SYSGEN(MOVE) procedure to move the files to the 
appropriate user name. Refer to chapter 8 for more information about SYSGEN(MOVE). 

Subsystem Enable and Disable Commands 

In addition to procedure file creation and placement, you must issue ENABLE 
commands to tell the system the control point at which the subsystem is to operate, as 
well as what system functions are required. You can enter the ENABLE (or DISABLE) 
commands at the system console or you can add them to the IPRDECK. Table 7-1 lists 
the appropriate ENABLE commands. DISABLE commands are similar. 

Automatic Subsystem Initiation 

To automatically initiate a subsystem when you enter the DSD AUTO or 
MAINTENANCE commands, do the following: 

• Ensure that the startup procedure file has the 3-character name of the subsystem 
and is stored as an indirect access file on user name SYSTEMX. 

® Enable-the subsystem and any other system functions by adding the appropriate 
ENABLE entries to the IPRDECK. (The released IPRDECKs contain default 
ENABLE commands for all ordered subsystems, except FSE and Dual State. No 
control points are assigned except for NAM, which is assigned control point 2.) 
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Subsystem Initiation 


Table 7-1 summarizes the subsystem procedure names and the appropriate ENABLE 
commands necessary for initiating the subsystem. 


Table 7-1. Subsystem Initiation 


Installation 

Procedure 

Subsystem 

Procedure 
File Name 

ENABLE Commands 

CDCS2 

CDC 

CDC 

ENABLE,SCP. 

ENABLE,CDC,n. 1 

DUAL 

NVE 

2 

ENABLE,SCP. 

ENABLE,NVE.n. 1 

FSE 

SMF 

SMF 

ENABLE,SCP. 

ENABLE, SMF, n. 1 

IAF 

IAF 

IAF, 

IAFTM, 

IAFTR 

ENABLE,SCP. 

ENABLE,IAF. 

MCS 

MCS 

MCS 

ENABLE,SCP. 

ENABLE,MCS,n. 1 

MSE 

MSE 

MSE 

ENABLE,SCP. 

ENABLE,MSE,n. 1 

ENABLE,MASTER MSE. 

ENABLE,CARTRIDGE PF STAGING. 

MSSI' 

MAP 

MAPCMI, 

MAPECS, 

MAPCH 

ENABLE,SCP. 

ENABLE,USER EXTENDED MEMORY. 
ENABLE,MAP,n. 1 

NAM5/NAM5D 

NAM 

NAM, 

NAMNOGO 

ENABLE,SCP. 

ENABLE,NAM,n. 1 

NSS 

SSF 

SSF 

ENABLE,SCP. 

ENABLE,SSF,n. 1 

NOS 

MAG 

MAG 

ENABLE.MAG. 

RBF5/RBF5D 

RBF 

RBF is 
initiated by 
NAMI 

None 


1. n stands for control point number. 


2. You must create your own NVE initiation procedure. Refer to the NOS/VE 
Software Release Bulletin and the DUAL section later in this chapter for complete 
information. 


(Continued) 
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Table 7*1. Subsystem Initiation (Continued) 


Installation 

Procedure 

Subsystem 

Procedure 
File Name 

ENABLE Commands 

RDFEX 

RDF 

RDF 

ENABLE,RDF. 

RHF 

RHF 

No 

procedure 

ENABLE,SCP. 

ENABLE.RHF^. 1 

TAF 

TAF 

TAF 

ENABLE,SCP. 

ENABLE,SUBCP. 

ENABLE,TAF,n. 1 

1. n stands for control point number. 


NOTE 


• RDF and MAG are always added to the deadstart file for system maintenance 
purposes. All other procedures are placed only on permanent files. 

• MSE and RDF may require additional IPRDECK entries (refer to the NOS 
Version 2 Analysis Handbook). 

• For more information about the IPRDECK ENABLE and DISABLE commands and 
subsystem startup, refer to the NOS Version 2 Analysis Handbook. 

• Enable either IAF or RDF, not both. To help maintain access security to RDF, 
enable RDF only when needed as specified in the NOS Online Maintenance 
Software Reference Manual (60454200). 

• If you do not want to store the startup procedure files on user name SYSTEMX, 
you can put the procedure files on the deadstart tape and add *PROC directives to 
your LIBDECK. For more information, refer to the NOS Version 2 Analysis 
Handbook. 
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AAM2 - CYBER Record Manager Advanced Access 
Methods Version 2 

This section describes these installation options for AAM2: 

• USER File Directives 

• Additional Procedures 

USER File Directives 

If you want to gather additional file statistics, include the Update directive * DEFINE 
STATS in a USER file. (Without this directive, the system gathers only normal file 
statistics.) 

Additional Procedures 

AAM2 includes one system compression/decompression routine. You can add up to 53 
additional compression/decompression routines as system routines. Encapsulate each 
added routine and modify the capsule OPNM$AA. 

Each routine must have an entry point of the form CMPR$nn (nn is two decimal 
digits within the range 11 through 63). The entry point name for the first added 
routine must be CMPR$11, the entry point name for the second routine must be 
CMPR$12, and so forth. The entry point must be the second word (word 1) of the 
routine. 

The first three words of each routine must have the format shown in table 7-2. 


Table 7-2. Format of First Three Words of Compression/Decompression Routines 


Word 

Bits 

Contents 

0 

59 through 18 

Entry point name, 6-bit display code, left-justified, zero 
fill. 


17 through 0 

1 . 

1 

59 through 18 

0 . 


17 through 0 

Starting address of compression code. 

2 

59 through 18 

0 . 


17 through 0 

Starting address of decompression code. 
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An example of the construction of a single site-added compression/decompression routine 
follows: 


CMPR$11 

I DENT 

ENTRY 

VFD 

VFD 

VFD 

CMPR$11 

42/0,CMPR$11,18/1 
42/0,18/COMPRES 
42/0.18/EXPAND 

COMPRES 

BSS2 

1 


EQ 

COMPRES 

EXPAND 

BSS2 

1 


EQ 

END 

EXPAND 


The CYBER LOADER requires standard relocation for fast dynamic loading of capsules; 
therefore, construct the VFD statements as shown in the preceding example. A return 
jump to the address specified in word 1 or 2 of the routine results in the execution of 
the compression or decompression code. 

For each added routine, add an entry to the capsule name table in deck OPNMDAA. 
The macro GENTBL (also part of OPNMDAA) generates the table entry and has the 
following format. 

GENTBL name 

Parameter Description 

name Entry point name specified in word 0 of added routine. 

Specify table entries in consecutive, ascending numerical order. For example, to add 
three routines, make the following change to OPNMDAA. 

♦B OPNMDAA.329 

GENTBL CMPRS11 
GENTBL CMPR$12 
GENTBL CMPR$13 

*C OPNMDAA,DICODAA,CWEOR1,OPENDAA 
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To add one additional compression/decompression routine, execute a job similar to the 
following. Either it must be a system origin job, or you must have system origin 
privileges and have DEBUG on. 


Job Comments 

job command. 

USER,insun,password. 


BEGIN,PRDIN,INSTALL,PRDNAME=AAM2,DISK=0. 
UPDATE,K. 

RFL,65000. 

COMPASS,A,I,S=TXTCRM,S=IPTE XT. 

SYMPL,ET=T,I,S=TXTCRM,S=IPTEXT. 

COMPASS,A. 

RETURN,COMPILE. 

GROUP,$AAM$$CTL$. 

CAPSULE,$OPNM$$AA$. 

CAPSULE,$CMPR$$11$. 

LDSET,OMIT=$SETUP.$/$RM$$SYS=$. 

LOAD,LGO. 

NOGO,NEWCAP. 

COMMON,SYSTEM. 

GTR,SYSTEM,OLD.ULIB/AAMLIB 
LIBEDIT,B=0. 

LIBGEN,F=NEW,P=AAMLIB. 

SYSEDIT. 

--eor— 

*IDENT 


•C OPNMDAA,DICODAA,CWEOR1,0PENDAA 
—eor— 


—eoi— 

♦DELETE CAP/OPNMSAA 
•FILE NEWCAP 
•BEFORE •,CAP/* 

—eor— 

•FILE AAMLIB 
—eoi — 


Assembles OPNMDAA and 
DICODAA. 

Compiles OPNMDAA. 

Assembles routine being added. 

Encapsulates the modified capsule 
OPNM$AA (deck OPNMDAA) and 
the 

new compression capsule. 


User must be validated to access 
common files. 


Update directives to modify 
OPNMDAA. 


Compression/decompression routine 
being added (COMPASS). 
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APL2 - APL Version 2 

The installation of APL2 consists of building APL2 and then installing APL2 
permanent files. This section describes these installation options for APL2: 

• Unique Parameters 

• APL Entry Message 

• SYSGEN Functions 

• APL Validation Requirements 

Unique Parameters 

TERMTYP=ttype You can specify TERMTYP = ttype on the call to the APL2 

installation procedure, ttype defines the default terminal type. 
Refer to your listing of DECKOPL for allowable parameter 
values. The default for ttype is APLAS. 

APL Entry Message 

If you want to provide an APL entry message (a one-line message displayed when a 
user activates APL with a command), create a file named MESSAGE and make it local 
just prior to calling the APL2 installation procedure. The file must contain only a 
one-line message that cannot exceed 80 characters. 


SYSGEN Functions 

Only the APL loader can be captured on a deadstart tape. Except for the loader, APL2 
runs from a set of permanent files. 

SYSGEN installs all APL files on user names APLO and APL1. If you customize the 
APL files, install the modified files by performing these steps: 

1. Before running the APL2 installation procedure, execute these commands from 
your installation user name: 

PURGE(PFGAPL2/NA) 

DEFINE(PFGAPL2/CT=S) 

RETURN(PFGAPL2) 

2. Run the APL2 installation procedure. When the job has finished executing, enter 
these commands at the system console: 

X.DIS. 

USER(SYSTEMX,SYSTEMX) 

ATTACH(PFGAPL2/UN=1nsun) 

SYSGEN(APL2) 

Once the SYSGEN(APL2) command is completed, the user names APLO and APL1 will 
have the updated APL permanent files. 
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APL Validation Requirements 

User names APLO and APL1 are required for running APL. If you have no validation 
file, SYSGEN automatically creates the user names and assigns default passwords. If 
you have a validation file, you must create user names APLO and APLl with the 
limits shown in table 7-3. 

If you want to change the default passwords for the two user names (APLO and 
APLl), use the MODVAL command. Refer to the NOS Version 2 Administration 
Handbook for information about using MODVAL and about changing validation files. 

If you want to use SYSGEN to reload files on these user names, you must 
temporarily set the passwords to the default values or you must update the SYSGEN 
file ZZSYSGU. (Refer to SYSGEN Validations in chapter 8.) 


Table 7-3. Recommended Limits for APLO and APLl 


Resource or 

Capability 

Mnemonic 

User APLO 

Keyboard 

Entry 

User APLO 

Converted 

Value 

User APLl 

Keyboard 

Entry 

User APLl 
Converted 

Value 

AW 

1 

2 

1 

2 

cc 

77B 

Unlimited 

77B 

Unlimited 

CM 

CN 

40B 

2037B 

40B 

2037B 

CP 

77B 

Unlimited 

77B 

Unlimited 

CS 

4B 

4096 

4B 

4096 

DB 

5B 

10 

5B 

10 

DF 

73B 

1008 

73B 

1008 

DS 

DT 

3B 

1536 

2B 

1024 

EC 

0B 

0B 

0B 

0B 

FC 

7B 

Unlimited 

7B 

Unlimited 

FS 

6B 

192 

6B 

192 

IS 

NULL 

Null 

NULL 

Null 

LP 

77B 

Unlimited 

77B 

Unlimited 

MS 

6B 

25088 

6B 

25088 

MT 

3 

3 

3 

3 

PA 

PN 

EVEN 

Even 

EVEN 

Even 

PT 

77B 

Unlimited 

77B 

Unlimited 

PW 

APLO 

APLO 

APLl 

APLl 

PX 

HALF 

Half 

HALF 

Half 

RO 

37B 

System 

37B 

System 

RP 

SC 

2 

2 

2 

2 

SL 

SP 

77B 

Unlimited 

77B 

Unlimited 

TC 

NORMAL 

Normal 

NORMAL 

Normal 

TL 

77B 

Unlimited 

77B 

Unlimited 

TT 

UP 

TTY 

TTY 

TTY 

TTY 


1. Entry is CASF, CAND, CSRP, CPWC, CLPF, CSPF, CCNR. 


2. Value is 00000000000000000755. 
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BAM - CYBER Record Manager Basic Access Methods 
Version 1 

This section describes the following: 

• Installation Parameters 

• Installation Procedure Messages 

Installation Parameters 

The following installation parameters for BAM are defined in the Update common 
decks /CMNTXT/ and /TXTCRM/. Assemble deck TXTCRM to obtain a listing of the 
common decks. 

Parameter Default Significance 

Specifies use of compare and move unit (CMU) instructions 
in routine MOVE$RM. To remove the CMU code, delete the 
definition of CMU. To remove the no CMU code, delete the 
definition of NOCMU. If CMU and NOCMU are both defined, 
the CYBER Record Manager determines at run time which 
MOVE routine to use by checking the CMU flag in RA.CMU. 

The use of CMU instructions reduces the execution time of a 
program using the CYBER Record Manager for records of 
over 40 characters. The use of CMU instructions in programs 
to be executed on models 835, 840, 845, 850, 855, 860, 870, 
960, 990, 994, or 995 is not recommended. 

Number of words in tape label buffer. Because each user 
label requires 9 words, set LBLIM to 9m+ 1; m is the 
maximum number of file header (HDRn) labels allowed. 
Minimum value is 10 words. 


#CMU# 1 
#NOCMU# 1 


# LBLIM# 10D 


Installation Procedure Messages 


The DECKOPL installation procedure for BAM contains an update error. The following 
message appears in the load map: 


0*** YANK, SELYANK, OR YANKDECK IDENT 1EP NOT KNOWN*** 


The following message appears in the dayfile: 
1 NON-FATAL ERRORS 


This condition is non-fatal and does not affect the generated binaries. The frequency of 
occurrence is relative to this product as released; any local code may change the 
frequency. 
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BASIC3 - Basic Version 3 

This section describes the following: 

• Installation Parameters 

• Installation Procedure Messages 


Installation Parameters 

The following installation parameter for BASIC3 is defined in deck BASCOMP. 
Assemble this deck to obtain the Update sequence number required to change the 
released value. 

Parameter Default Description 

BDFLT 1.0 Array base; can be any nonnegative value expressed as a 

real value. 


The following parameters are defined in common deck LIPARAM. Assemble deck 
BASCARD to obtain a listing of LIPARAM. 


Parameter Default Description 


IP.AS 0 


IP.BL 0 


MESSAG 1 


Flag indicating default character set mode. A value of 0 
indicates normal (non-ASCII) mode (user must specify AS on 
the BASIC command to override the default); a value of 1 
indicates ASCII mode (user must specify AS=0 on the 
BASIC command to override the default). 

Flag indicating burstable listing. A value of 0 indicates 
nonburstable listing (user must specify BL on BASIC 
command to override the default); a value of 1 indicates 
burstable listing (user must specify BL = 0 on the BASIC 
command to override the default). 

Flag indicating whether BASIC issues time and memory use 
dayflle messages. A value of 0 inhibits issuing of messages; 
a value of 1 enables issuing of messages. 


Installation Procedure Messages 

The DECKOPL installation procedure for BASIC3 contains two errors. The following 
messages appear in the dayflle: 

COPYL DID NOT FIND — REL / BASSRE1 
COPYL DID NOT FIND — REL / BASSRE2 

This condition is non-fatal and does not affect the generated binaries. The frequency of 
occurrence is relative to this product as released; any local code may change the 
frequency. 
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CCL - CYBER Control Language Version 1 

This section describes these installation options for CCL: 

• Installation Parameters 

• Additional Procedures 

Installation Parameters 

The following installation parameters are located on deck CCL. Since installation 
procedures use the default values, changing the values is not recommended. 

Parameter Default Description 

IP.ATT 1 Flag indicating whether the system searches the user 

name’s permanent file catalog, if the requested procedure 
file is not local. 

Value Definition 

0 Permanent file catalog not searched. 

1 Permanent file catalog searched. To attach the 

requested procedure file, the system searches the 
indirect access files first and then the direct 
access files. 

IP.DPF 1 Flag indicating logical existence of default procedure file 

name. 

Value Definition 

0 No default procedure file name. 

1 Procedure file name defaults to value of IP.DPFN. 

IP.DPFN PROCFIL Default procedure file name. 
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Parameter 

Default 

Description 

IP.EXP 

100 

Number of operands and operators allowed in a CCL 
expression. For each unit that this parameter is decreased 
from 100, the execution size of CCL is reduced by two 
words. 

IP.FP 

50 

Maximum number of keywords in a procedure call or 
procedure header directive. Maximum value is 500. 

IP.FPC 

10 

Maximum number of characters in a keyword for a 
procedure call or procedure header directive. Maximum 
value is 10. 

IP.LCS 

10 

Maximum number of characters in a label string. Maximum 
value is 10. 

IP.NPV 

6 

Value used to calculate the size of the pattern value table 


(PVT). The PVT stores the checklist entries for each 
parameter in the procedure headers. The following formula 
determines the size of the PVT in words: 


PVT = IP.NPV * IP.FP » 2 

The PVT contains the procedure title, the parameter 
label/prompt, and the checklist patterns and values. The 
PVT also contains prompt strings from the following 
directives: 

• CORRECT 

• ENTER 

• FI through F7 

• NOCLR 

• NOTE 

• PAGE 

• PROMPT 
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Parameter 

IP.PNL 

IP.RLD 


IP.SCL 

IP.SCS 

IP.TAPO 


Default Description 

50 Procedure nesting limit. Maximum value is 1023. 

1 Flag indicating whether the system does a sequential or 

random search of a library to find the requested procedure. 

A random search is usually faster than a sequential search. 

Value Definition 

0 Search library sequentially. 

1 Search library randomly by using the library 

directory. 

150 Maximum length in characters of lines in a procedure. Any 

restrictions as to the length of a command remain in effect, 
but a comment following the command terminator may 
extend to the length specified by IP.SCL. 

40 Maximum number of characters for default and actual 

values. Maximum value is 80. 

1 Flag indicating whether a procedure can reside on tape. 

Value Definition 

0 Procedure file cannot reside on tape. BEGIN hangs 

in RECALL if execution from tape is attempted. A 
value of 0 decreases the execution size of CCL by 
7008 words for BEGIN, REVERT, WHILE, and 
ENDW. 

1 Procedure file can reside on tape. 
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Additional Procedures 

CCL consists of three absolute overlays with entry point names and verb table entries 
for each CCL verb (command). Here are the CCL verbs and overlays: 

Overlay Verbs 

CCLBRWE BEGIN, REVERT, WHILE, ENDW 

CCLIFES IF, IFE, ELSE, ENDIF, SKIP 

CCLDS DISPLAY, SET 

If a CCL verb must be changed because of a conflict with an existing program on the 
deadstart file, change both the entry point name and the verb table entry in the CCL 
overlay in which they occur. 

NOTE 


The field length allocated to CCLBRWE for prolog processing is defined in NOS deck 
PPCOM by symbol CCFL. Changes to CCL installation parameters or local code 
added to CCL may require adjustment of the value of this symbol and reassembly of 
NOSTEXT and VALEX. 
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CCP - CYBER CROSS System and Communications 
Control Program 

This section describes the following: 

• Hardware Requirements 

• Configuration Information 

• Released Software Variants 

• Build Steps Description 

• Binary Installation Option 

• General Build Step Call 

• CCP/CROSS Permanent Files 

• Security Character Parameters 

• CROSS - CROSS System Installation 

• CCPPH1 - CCP Phase 1 

• CCPBLB - CCP Binary Library 

• CCPVAR - CCP Variant 

• CCPEDIT - Edit Variant Module 

• CCPLOAD - Generate CCP Load File 

• CCPPURG - CCP/CROSS Installation Files Purge 

• CCP System Definition 

• CCP Variant Load Module Definition 

• CCP Load File Definition 

• CCP Extra PLs Definition 

• CCP/CROSS Installation Examples 
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Hardware Requirements 

A field length of 1100008 is required to build CCP. The following equipment 
configuration is the minimum required to execute CCP: 

• One 2550-2, 2551-1, 2551-3, or 2551-4 Host Communication Processor, consisting of 
at least the following items: 

- One multiplexer loop interface adapter. 

- One loop multiplexer. 

- One cyclic encoder board. 

- One CYBER communications coupler. 

- One memory unit. 

- One 8K micromemory board. 

• One communications line adapter (CLA), either a 2560-1 synchronous CLA or a 
2561 asynchronous CLA. 

• Total 2550 memory of at least 65K. 

Assign the CLA slots in the loop multiplexer in order of decreasing line transmission 
speeds. For example: 


Speed 

Slot Assignment 

9600-bits per second 
(bps) line 

Slot 1 (leftmost slot) 

9600-bps line 

Slot 2 

2400-bps line 

Slot 3 

300-bps line 

Slot 4 

150-bps line 

Slot 5 
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Configuration Information 

Configuring CCP consists of generating the proper Network Load File (NLFFILE) for 
the 255x NPU hardware configuration and network software interfaces needed at your 
site. Each NPU variant within the load file is created to match the memory size of the 
255x NPU and to contain the correct set of Terminal Interface Processors (TIPs) based 
on the communications protocols (async, HASP, X.25, etc.) used at your site. The 
specific variant to be used by each NPU is referenced through the VARIANT parameter 
on the NPU statement in the NDL file. The NLFFILE is stored as a direct access 
permanent file on the network administration user name. It should be a private file 
with read permission given to the network operations user name. NLFFILE can also be 
public or semiprivate. 

An NLFFILE that contains several variants for different 255x NPU configurations 
and TIP combinations is included with the release materials. The specific entries are 
based on the options selected from the OIP. Refer to Released Software Variants in 
this section for a list of the variant names and their contents. 

If you customize your own variants and load file, the load file generated by the 
CCPLOAD procedure must be moved from the installation user name to the network 
administration user name. Before the file is moved, it should be renamed from Gzzz 
(where zzz is value of the GN parameter from the CCPLOAD procedure call) to 
NLFFILE. 

Released Software Variants 

When you ordered CCP, you selected from one of six possible options (A through F). 

No matter which option you selected, you receive the CCP source program library file 
containing build output listings, a ready-to-use CCP load file, a sample Network 
Definition Language (NDL) file, and variant build output files for all CCP variants in 
your load file. 

Table 7-4 lists the six options (A through F) available when ordering CCP and which 
variants are given with each. The load file received contains the variants listed for 
each option. 


Table 7-4. Options and Variants with CCP 


Option Variants Received 

A 

V1F, 

V2F, 

V3F, V4F, SMI, 

SM2, 

SM3, SM4 

B 

V1L, 

V2L, 

V3L, V4L, V1F, 

V2F, 

V3F, V4F, SMI, SM2, SM3, SM4 

C 

SMI, 

SM2, 

SM3, SM4 



D 

SMI, 

SM2, 

SM3, SM4 



E 

SMI, 

SM2, 

SM3, SM4 



F 

SMI, 

SM2, 

SM3, SM4 
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Table 7-5 describes the released CCP variants. 


Table 7-5. Released CCP Variants 


Variant 

Name 

NPU 

Size 

Host 

Interface 

Program 

(HIP) 

Link 

Interface 

Program 

(LIP) 

Buffer 

Space 

Terminal Interface Programs 
(TIPs) 

V1F 

96K 

YES 

NO 

42K 

ASYNC, HASP, BISYNC 

V2F 

96K 

YES 

NO 

42K 

ASYNC, MODE4 

V3F 

96K 

YES 

NO 

42K 

ASYNC, X.25 A-A, X.25 PAD 

V4F 

128K 

YES 

NO 

37K 

ASYNC, HASP, MODE4, 

BISYNC, X.25 A-A, X.25 PAD 

V1L 

96K 

YES 

YES 

37K 

ASYNC, HASP, BISYNC 

V2L 

96K 

YES 

YES 

42K 

ASYNC, MODE4 

V3L 

96K 

YES 

YES 

40K 

ASYNC, X.25 A-A, X.25 PAD 

V4L 

128K 

YES 

YES 

42K 

ASYNC, HASP, MODE4, 

BISYNC, X.25 A-A, X.25 PAD 

SMI 

65K 

YES 

NO 

24K 

ASYNC 

SM2 

65K 

YES 

NO 

19K 

ASYNC, HASP 

SM3 

65K 

YES 

NO 

15K 

ASYNC, BISYNC 

SM4 

65K 

YES 

NO 

18K 

ASYNC, MODE4 


When SYSGEN is executed, a compiled NDL (LCFFILE and NCFFILE) is placed on 
the network administration user name. The source for the NDL is placed on the 
network administration user name as file NDLDATA. The NDL for options A and B 
specifies SMI. The compiled NDL for options C through F specifies the variant name 
described on the OIP (option C specifies SMI, D specifies SM2, E specifies SM3, and F 
specifies SM4). 
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Build Steps Description 


The CCP/CROSS installation procedures consist of seven sequential build steps. The 
following build step descriptions are listed in their proper execution sequence. 


Build Step 

Description 

CROSS 

Updates the CROSS program library on the CRSS source file with 
corrective code from file CODEPL and with user corrective code from 
file UCRS; compiles the updated binaries for use by the CCP build 
steps; writes an updated version of CRSS. 

CCPPH1 

Updates the program libraries on the CCPB, CCPD, CCPT, and CCPR 
files with corrective code from file CODEPL and then merges the 
updated program libraries into file PCMB; creates updated program 
libraries of CCP (PCCP), online diagnostics (PDGN), the 3270 TIP 
(PBST), and remote concentrator products (PREM) and any other 
user-supplied program libraries; updates PCMB with temporary 
user-supplied corrective code from file UCCP and generates the phase 1 
(micromemory) and dump load modules on file ZMUX; creates EXPAND 
and Autolink binaries; builds system autostart (SAM) load module; 
writes updated versions of CCPD, CCPT, and/or CCPR. 

CCPBLB 

Updates the PCMB program library with temporary user-supplied 
corrective code from file UCCP and generates the CCP object code 
library (BCMB); writes an updated version of CCPB. This build step is 
also called the CCP full compile and assembly build step. 

CCPVAR 

Updates the PCMB program library with temporary user-supplied 
corrective code from file UCCP and generates a CCP variant load 
module (Zvvv) and program initiation control block (PICB) file (Ivvv) 
from the BCMB file according to the user-specified variant definitions 
in file USERBPS; writes Vvvvpsrout. This build step should be repeated 
for each variant in the network. 

CCPEDIT 

Patches a CCP variant load module. This build step is not part of the 
normal build process but allows the use of the MPEDIT utility of 
CROSS. 

CCPLOAD 

Updates the PCMB program library with temporary user-supplied 
corrective code from file UCCP and generates a NAM network load file 
(Gzzz) using program LFG (refer to the NOS Version 2 Analysis 
Handbook). The load file includes the phase 1 and dump load modules 
(file ZMUX) and system autostart load module (file ZSAM) from step 
CCPPH1, and the variant load modules (Zvvv) and PICBs (Ivvv) from 
step CCPVAR. 

CCPPURG 

Purges the noncritical permanent files created by the other build steps. 
It does not purge the load file from build step CCPLOAD and the 
user-supplied files. This build step is not required; it is only a cleanup 
utility. However, since previous build steps do not purge the noncritical 
permanent files, it is suggested that CCPPURG be run to make more 
disk space available. 
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The CCP/CROSS build steps ultimately generate a NAM network load file (NLFFILE). 
Figure 7*1 illustrates the build step dependencies. Figure 7-2 illustrates the 
relationship of the load file to the release files and the other files critical to the CCP 
installation process. Figure 7-3 illustrates the relationship of build steps to critical files 
and tapes involved in CCP installation. 



Figure 7-1. CCP/CROSS Build Step Dependencies 
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Figure 7-2. CCP File Dependencies 
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CCP - CYBER CROSS System and Communications Control Program 
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Binary Installation Option 

To speed up the process of installing CCP/CROSS, Control Data provides the following 
prebuilt files on the permanent file tapes: 

• All permanent files necessary to begin the build process with the CCPVAR step. 

• Several CCP variants and a load file. (The variants are described in Released 
Software Variants earlier in this section.) 

Thus, you can skip the first three steps of the build process (the CROSS, CCPPH1, and 
CCPBLB steps) if these two conditions are true: you do not want to add user code to 
the omitted build steps and you do not need to add online diagnostics or the 3270 TIP. 
(If you ordered the Remote Concentrator Products, they are included in the CCP files.) 

The files required for a CCP binary installation were loaded by the command: 

SYSGEN(SOURCE,CCP) 

executed in Step 1 of chapter 6. 

This installation command loads all CROSS and CCP permanent files and the 
USERBPS file to your user name. If you can use both the CROSS and CCP files, 
modify the LFD and VRD statements in file USERBPS and begin your CCP/CROSS 
installation with the CCPVAR step. If you can use only the CROSS binaries, you 
should create your USERBPS file and begin your installation with the CCPPH1 step. 
(For information about the USERBPS file, refer to User-Supplied Files under 
CCP/CROSS Permanent Files later in this section.) 

NOTE 


Complete CCP/CROSS and variant build listings (as provided by the CCPLIST=PF or 
VARLIST = PF options) are provided on the permanent file tapes in the CCP/CROSS 
and variant release files. 


Revision L 


Special Product Installation Information 7-23 


CCP - CYBER CROSS System and Communications Control Program 


General Build Step Call 


All CCP/CROSS build steps are called by the BEGIN command. Descriptions of each of 
the seven sequential build step procedures, including the required BEGIN parameters, 
are in subsequent subsections. Table 7-6 summarizes the tape and disk file 
requirements of the build steps. 


Table 7-6. CCP/CROSS Tape and Disk File Requirements 


Build 

Build 

Input Files 

User 

Permanent 

Optional 

Permanent 

Step 

Step 

Generated by 

Input 

Files 

Files 

Order 

Name 

Previous Step 

Files 

Created 

Created 


1 

CROSS 


UCRS 

LCRB 





USERCHG 

PCRS 





CODEPL 

Addd 


2 

CCPPH1 

Addd 

UCCP 

ZMUX 

LIMC 




USERCHG 

PCMB 

LMFB 




CODEPL 

PCCP 

PDGN 





ZSAM 

PREM 





SMUX 

PBST 






LSAM 

3 

CCPBLB 

PCMB 

UCCP 

BCMB 

LFCA 



ZMUX 

USERCHG 





ZSAM 

USERBPS 





SMUX 




■ 


Addd 




4 

CCPVAR 

PCMB 

UCCP 

Zvvv 

Lvvv 



BCMB 

USERBPS 

Svvv 




SMUX 

USERCHG 

Ivvv 


5 

CCPEDIT 

Zvvv 

UEDZ 

Zyyy 



(optional) 

Svvv 

USERCHG 

Syyy 


6 

CCPLOAD 

PCMB 

UCCP 

Gzzz 




ZMUX 

USERBPS 





ZSAM 

USERCHG 





Zvvv 






Ivvv 




7 

CCPPURG 


USERCHG 




(optional) 






Refer to CCP/CROSS Permanent Files later in this section for file descriptions. 
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The parameters used by the CCP installation procedures are listed below. The common 
parameters CCPLIST, NOECS, NOPURGE, and VARLIST used in the installation 
procedure call can be set in file COMMOD with the values described below. Refer to 
chapter 9 for information about modifying parameters in file COMMOD. 

Parameter Description 

BSTP = bstp Specifies whether the 3270 TIP program library is present 

(CCPT); used only with CCPPH1. The default is BSTP = NO. 

CCPLIST=option or Specifies whether the build step creates a listing, saves the 
VARLIST = option listing as a permanent file on disk, and/or assigns the listing 

to OUTPUT. Do not specify either parameter for the 
CCPLOAD build step. The default is CCPLIST=NO for 
CROSS, CCPPH1, and CCPBLB, and VARLIST = PF for 
CCPVAR. 


DIAG=diag 


BOTH Listing is stored as a permanent file as well as 

assigned to OUTPUT; later it is copied to the new 
release file and the permanent file is purged. 

NO No listing is created. 

PF Listing is stored as a permanent file on disk; later 

it is copied to the new release file and purged 
from the disk. 

YES Listing is assigned to OUTPUT. For the CCPVAR 

build step, listing is also copied to the new release 
file. 

Specifies whether online diagnostics are present (CCPD); used 

only with CCPPH1. The default is DIAG=NO. 


GN = zzz Specifies load file name. The user supplies the 3-character, 

alphanumeric file name, which is found in the USERBPS file 
under the load file definitions; used only with CCPLOAD. 
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Parameter 

NEW = vvv 2 


NOECS 


NOPURGE 


OLD = vvvi 


REMT = remt 


VN = vvv 


Vx = vvv x 


XREF = xref 


XTRAPLS = xtrapls 


Description 

Specifies new CCP variant name for the patched load module; 
used only with CCPEDIT. Supply the 3-character alphanumeric 
name. 

Specifies that extended memory is not used for build steps 
CCPPH1 and CCPBLB. Supply this parameter only when 
extended memory is down or when you do not want to use 
extended memory even if it is available. This parameter is not 
required if there is no extended memory or if fewer than 
770008 words of extended memory are available. 

Specifies that routine DRTBAT1 does not purge files PCCP, 
LIMC, LMFB, LSAM, and LFCA. The default is to purge 
these files. 

Specifies the CCP variant to be patched; used only with 
CCPEDIT. Supply the 3-character alphanumeric name. 

Specifies whether remote concentrator products are present 
(CCPR); used only with CCPPH1. The default is REMT=NO. 

Specifies a variant name that matches the variant name in 
the VRD definition in USERBPS; used only with CCPVAR. 

Specifies the variant name that was used in CCPVAR; used 
only with CCPPURG. x is an integer within the range 1 
through 10. 

Specifies whether the build step generates a cross-reference 
listing of the Pascal source of CCP; used only with CCPBLB. 
The default is XREF = NO. 

Specifies whether extra program libraries are to be merged 
into the PCMB; used only with CCPPH1. The default is 
XTRAPLS=NO. 
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CCP/CROSS Permanent Files 

All permanent files generated by the CCP/CROSS installation procedures are named by 
the following convention: each name consists of 4 characters and the first character 
identifies the file type. The first character can be any of the following file types: 

File Type Description 

A Absolute load file (CROSS program). 

B Binary library or LGO file. 

C Permanent corrective code in Update format with master control 

character of /. 

G CCP load file created by the load file generator (LFG) program. 

I Program initiation control block (PICB). 

L CCP/CROSS listing (generated during installation). 

P Program library in Update format. 

S CCP symbol table. 

U User-supplied corrective code file. 

Z Load modules required by CCPLOAD. 
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An alphabetical list of permanent files generated by the CCP/CROSS installation 
follows. Files are grouped by their file types. 


Absolute Load Files 

Description 

AALK 

Autolink program. 

AASM 

CROSS macro assembler. 

ACYP 

CYBER 180, CYBER 170, CYBER 70, and 6000 Computer 
Systems Pascal compiler. 

AEDT 

MPEDIT program. 

AEXP 

Build parameters expand program. 

AFMT 

Pascal binary output formatter program. 

ALIB 

MPLIB program. 

ALNK 

MPLINK program. 

AMAC 

Macro assembler text file. 

AMAS 

CROSS micro assembler. 

APAS 

MP17 Pascal compiler. 

AXRF 

Pascal cross-reference program. 

Binary Library File 

Description 

BCMB 

Combined CCP/diagnostics/remote concentrator products/3270 

TIP binary library. 

Corrective Code File 

Description 

CODEPL 

Corrective code for CCP/CROSS. 

CCP Load File 

Description 

Gzzz 

CCP load file generated by CCPLOAD (the zzz appended to 
the letter G is the value of the GN parameter). 

CCP PICB Load 
Modules 

Description 

Ivvv 

CCP program initiation control block load modules. 

CCP Listings 

Description 

LCRB 

CROSS system listings. 

LFCA 

Full compile assembly listings. 

LIMC 

Expand and autolink program listings. 

LMFB 

MUX firmware and dump bootstrap overlay listings. 

LSAM 

System autostart (SAM) listing. 

Lvvv 

Variant load module listing (vvv is variant name). 
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Program Libraries 

Description 

PBST 

New 3270 TIP program library. 

PCCP 

New CCP program library. 

PCMB 

Updated combined program library. 

PCRS 

New CROSS program library. 

PDGN 

New diagnostic program library. 

PREM 

New remote concentrator products program library. 

Symbol Tables 

Description 

SMUX 

Symbol table for dump bootstrap. 

Svvv 

Symbol table for load module Zvvv. 

User-Supplied Files 

Description 

UCCP 

Optional direct or indirect access permanent file of user code 
corrections to CCP. The contents of this file should be the 
same for all build steps requiring it. 

UCRS 

Optional direct or indirect access permanent file of user code 
corrections to CROSS. This file is used only with build step 
CROSS. 

UEDZ 

Optional direct or indirect access permanent file of MPEDIT 
directives to patch a CCP variant load module. This file is 
used only with build step CCPEDIT. 

USERBPS 

User build parameters file. This indirect access permanent 
file contains the CCP system definition, the CCP variant 
load module definitions, and the CCP load file definitions. 

This file is required for build steps CCPBLB, CCPVAR, and 
CCPLOAD. For each execution of CCPVAR, the USERBPS 
file must remain unchanged. A complete description of 
USERBPS immediately follows this listing of the permanent 
files. 

NOTE 


All CCP/CROSS user-supplied files must be permanent files under the same user 
name used for the build step jobs. The USERCHG file must be an indirect access 
permanent file. Local files of the same name are ignored. 
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Load Modules 

Description 

ZMUX 

MUX load module firmware and dump bootstrap overlay. 

ZSAM 

SAM load module. 

Zvvv 

CCP variant load modules (vvv is variant name). 

NOTE 


If the CCP/CROSS build process is interrupted, you must ensure that the required 
files are present upon resumption. 


USERBPS File 

Create a build parameters file (indirect access permanent file USERBPS) containing a 
CCP system definition, CCP variant load module definitions, and CCP load file 
definitions. Build steps CCPBLB, CCPVAR, and CCPLOAD require this file. During the 
build step CCPPH1, the utility program EXPAND searches through USERBPS for the 
extra program library definitions. During build step CCPBLB, the utility program 
EXPAND searches through USERBPS for the system (SYS) definition. It then expands 
the definition, according to a macro text file, into Update directives that control the 
options and TIPs that are assembled and compiled into the combined binary library 
(BCMB). For build steps CCPVAR and CCPLOAD, parameters specify the desired 
variant or load file definition. EXPAND then searches for and expands the definition in 
the same manner as described for the system definition. The Update directives created 
cause input to be generated for the AUTOLINK program. 

USERBPS can contain any number of CCP system, variant, and load file definitions. 
(Refer to the sample USERBPS file, under CCP/CROSS Installation Examples, later 
in this section.) If more than one system definition is present, only the first definition 
is used. The format of CCP build definitions follows: 

keyword1=value1,...,keywordn=valuen. 

When a keyword takes on multiple values, the form follows: 

keyword1=value1/.../valuen. 

This is equivalent to the following: 

keyword1=va1ue1,...,keyword1=valuen. 

The following syntax rules apply to all definitions. 

• The first keyword must be one that identifies the type of definition (VRD 
indicates a variant definition and LFD indicates a load file definition). 

• EXPAND ignores all embedded blanks. Blank lines are illegal. 

• A period terminates each definition. 

• Continuation lines must begin with a plus ( + ). 

• EXPAND treats any line whose first character is an asterisk (*) as a comment 
line. 
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• When a definition takes more than one line, the user should break the definition 
between parameter pairs. 

Security Character Parameters 

The specification of a security character for a particular TIP activates the secure login 
feature. This feature guarantees that the terminal user can request a connection to the 
Network Validation Facility (NVF) regardless of any action by a host program. As a 
result, the login information the user enters remains secure. The installer is 
responsible for maintaining the integrity of the network configuration files (LCFFILE 
and NCFFILE) such that the NVF login or autologin is not subverted. 

When the terminal user enters the security character in a specific sequence (refer to 
the NOS Version 2 Reference Set, Volume 3), CCP terminates any current connection 
and either reconnects the user to the host computer or prompts the user to select or 
connect to a host computer. 

The security character must be a 7-bit character (specified as a hexadecimal number) 
that is within the code set of the terminal specified in ASCII. The character is 
restricted to the values $03-$lF, $21-$2F, $3A-$3C, $3E-$40, $5B-$60, and $7B-$7E. 
The security character must not be the same value as specified for the abort block, 
backspace, user break 1, user break 2, cancel, control, end-of-line, or end-of-block 
character. Refer to the Network Definition Language Reference Manual for the 
default values for these characters. The secure login is not activated for any sub-TIP 
for which a security character is not specified (that is, value equals $00). 

Here are the parameter values in deck SECURITY in the CCPB PL. 


Parameter 

Default 

Security 

Character 

Terminal 

SCA2741 

$00 

Asynchronous 2741 terminals 

SCAN2741 

$00 

Asynchronous non-2741 terminals 

SCB2780 

$00 

IBM 2780 terminals 

SCB3270 

$00 

IBM 3270 terminals 

SCB3780 

$00 

IBM 3780 terminals 

SCHPOST 

$00 

HASP postprint terminals 

SCHPRE 

$00 

HASP preprint terminals 

SCMD4A 

$00 

Mode 4A terminals 

SCMD4C 

$00 

Mode 4C terminals 

SCXPAD 

$00 

X.25 package assembly/disassembly (PAD) 
terminals 

SCXUSER 

$00 

X.25 user-defined terminals 
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CROSS - CROSS System Installation 

The following build step generates updated program binaries for all CROSS programs 
and installs the programs needed for subsequent CCP build steps. Refer to General 
Build Step Call, earlier in this section, for descriptions of the parameters. 

BEGIN,CROSS,INSTALL,CCPLIST=option,NOPURGE. 

The CROSS build step uses the following files for input. 


File 

Description 

CODEPL 

CROSS corrective code, if any, that affects the resulting CROSS 
binaries but is not placed in the program library on the output file. 

CRSSpsrin 

CROSS release file. 

UCRS 

Optional site corrective code (refer to CCP/CROSS Permanent Files, 
earlier in this section). For a description of the CROSS installation 
parameters that can be changed, refer to Installation Parameters for 
CROSS, later in this subsection. 

The CROSS build step creates the following output files. 

File 

Description 

AASM 

CROSS macro assembler. 

ACYP 

CYBER 180, CYBER 170, CYBER 70, and 6000 Computer Systems 
Pascal compiler. 

AEDT 

MPEDIT program. 

AFMT 

Pascal binary output formatter program. 

ALIB 

MPLIB program. 

ALNK 

MPLINK program. 

AMAC 

Macro assembler text file. 

AMAS 

CROSS micro assembler. 

APAS 

MP17 Pascal compiler. 

AXRF 

Pascal cross-reference program. 

CRSSpsrout 

New CRSS program library. 

LCRB 

CROSS system listings (if requested). 
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Installation Parameters for CROSS 
The following parameters are in deck CROSS. 

Identifier Parameter Default Significance 


XSYA127.6 

MAXGLBL 

1535 

XSYA127.7 

HGHPAGE 

55 

XSYA127.8 

SYMTBSIZ 

1792 

XSYA127.9 

VARPAGE 

47 

XSYA127.406 

SYMTBSIZ 

1792 

XSYA127.407 

MAXGLBL 

1535 


Maximum number of global symbols 
minus one. 

(SYMTBSIZ/32)-l. 

Size of in-core symbol table. 

MAXGLBL/32. 

Size of in-core symbol table. 

Maximum number of global symbols 
minus one. 


The number of entries in the in-core symbol table in the release version of the Pascal 
compiler is 1792. This version of the compiler has a corresponding maximum number 
of global symbol definitions of 1536 and an execution field length of 770008 central 
memory (CM) words. Some programs require a Pascal compiler that accommodates 
more than 1536 global symbol definitions; for example, CCP requires 6144 global 
symbols. Increasing the size of the global symbol table without increasing the in-core 
symbol table, however, results in a significant increase in compilation time. Further, 
an increase in the number of CM words must accompany any increase in the size of 
the in-core symbol table (4 CM words per symbol table entry). 


CCPPH1 - CCP Phase 1 


The following build step generates a combined base program library for CCP, 3270 TIP, 
online diagnostics, and remote concentrator products program libraries. It also creates 
the multiplexer firmware and the dump load module. Refer to General Build Step Call, 
earlier in this section, for descriptions of the parameters. 

BEGIN,CCPPH1,INSTALL,DIAG=diag,REMT=remt,BSTP=bSt p.XTRAPLS=xt rap1s, 

CCPLIST=Opt ion ,NOECS,NOPURGE. 


The CCPPH1 build step uses the following input files. 
File Description 


CCPBpsrin CCP release program library. 

CCPDpsrin Diagnostic release program library (if DIAG=YES). 

CCPRpsrin Remote concentrator products release program library (if REMT=YES). 
CCPTpsrin 3270 TIP release program library (if BSTP = YES). 

CODEPL CCP corrective code, if any. 

UCCP Optional user corrective code. Refer to User-Supplied Files in 

CCP/CROSS Permanent Files, earlier in this section. 
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AALK Autolink program. 

AEXP Build parameters expand program. 

CCPDpsrout New diagnostic program library (if DIAG = YES). 

CCPRpsrout New remote concentrator products program library (if REMT = YES). 
CCPTpsrout New 3270 TIP program library (if BSTP = YES). 

LIMC Expand and Autolink program listings (if requested). 

LMFB CCP list file (if requested). 

File 1 Multiplexer firmware. 

File 2 Dump bootstrap overlay. 

LSAM System autostart (SAM) listing (if requested). 

PBST New 3270 TIP program library (if BSTP=YES). 

PCCP New CCP program library. 

PCMB Updated combined program library. 

PDGN New diagnostic program library (if DIAG=yes). 

PREM New remote concentrator products program library (if REMT=yes). 

SMUX Symbol table for dump bootstrap. 

ZMUX CCP load module. 


CCPPH1 generates the following output files. 
File Description 


File 1 Multiplexer firmware. 

File 2 Dump bootstrap overlay. 

ZSAM SAM load module. 
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CCPBLB - CCP Binary Library 

The following build step generates an updated combined binary library of all CCP 
procedures and assembly language subroutines. Refer to General Build Step Call, 
earlier in this section, for descriptions of the parameters. 

BEGIN,CCPBLB,INSTALL,CCPLIST=opt1 on,XREF=xref,NOECS,NOPURGE. 


CCPBLB 

File 

AALK 

AASM 

ACYP 

AEXP 

AFMT 

AMAC 

APAS 

AXRF 

PCMB 

SMUX 

UCCP 


requires the following input files. 

Description 
Autolink program. 

CROSS macro assembler. 

CYBER Computer Systems Pascal compiler (if XREF = YES). 
Build parameters expand program. 

Pascal binary output formatter program. 

Macro assembler text file. 

MP17 Pascal compiler. 

Pascal cross-reference program (if XREF = YES). 

Updated combined program library. 

Symbol table for dump bootstrap. 

Optional user corrective code. Refer to User-Supplied Files under 
CCP/CROSS Permanent Files, earlier in this section. 


USERBPS User variant build parameters file. Refer to User-Supplied Files under 
CCP/CROSS Permanent Files, earlier in this section. 


CCPBLB produces these output files. 

File Description 

BCMB Combined CCP/diagnostics/remote concentrator products/3270 TIP binary 

library. 

CCPBpsrout New CCP program library. 

LFCA Full compile assembly listings (if requested). 

File 1 Assembly source listing. 

File 2 Pascal source and object listing. 
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CCPVAR - CCP Variant 


The following build step generates a CCP variant load module and a PICB load module 
based on user-supplied variant definitions in file USERBPS. Refer to General Build 
Step Call, earlier in this section, for descriptions of the parameters. 

BEGIN,CCPVAR,INSTALL,VARLIST=opt1on.VN=vvv,NOPURGE. 

CCPVAR requires the following input files. 

File Description 

AALK 

AEDT 
AEXP 
AFMT 
ALNK 
APAS 
BCMB 


Autolink program. 

MPEDIT program. 

Build parameters expand program. 

Pascal binary output formatter program. 

MPLINK program. 

MP17 Pascal compiler. 

Combined CCP/diagnostics/remote concentrator products/3270 TIP binary 
library. 


PCMB Updated combined program library. 

SMUX Symbol table for dump bootstrap. 

UCCP Optional user corrective code. Refer to User-Supplied Files under 

CCP/CROSS Permanent Files, earlier in this section. 

USERBPS User variant build parameters file. Refer to User-Supplied Files under 
CCP/CROSS Permanent Files, earlier in this section. 

CCPVAR generates the following output files (vvv is the variant name). 

File Description 

I vvv CCP program initiation control block load modules. 

Lvvv Variant load module listing (if requested). 

Svvv Symbol table for load module Zvvv. 

Vvvvpsrout Variant release file. 

Zvvv CCP variant load module. 
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CCPEDIT * Edit Variant Module 

The following build step patches an absolute CCPLOAD module (file named Zvvv, 
where vvv is the CCP variant load module) via a special MPEDIT run (refer to the 
CYBER Cross System Build Utilities Reference Manual). The CCP build process 
requires this step only for those cases where there is a minor difference between an 
existing load module and the desired load module. Refer to General Build Step Call, 
earlier in this section, for descriptions of the parameters. 

BEGIN, CCPEDIT, INSTALL,OLD=WVl, NEW=Vw2. 

CCPEDIT requires four input files. 

File Description 

AEDT MPEDIT program. 

Svvvi Symbol table for load module Zvvvi. 

UEDZ Optional direct or indirect access permanent file of MPEDIT directives 

to patch a CCP variant load module. Refer to User-Supplied Files under 
CCP/CROSS Permanent Files, earlier in this section. 

Zvvvi CCP variant load module vvvi. 

CCPEDIT produces two output files. 

File Description 

Svvv2 Copy of symbol table Svvvi. 

Zvvv2 New CCP variant load module reflecting patch code. 
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CCPLOAD - Generate CCP Load File 

Based on user-supplied load file definitions in file USERBPS, the following build step 
generates a CCP load file used by network access method/network supervisor (NAM/NS) 
to downline load network processor units (NPUs). Refer to General Build Step Call, 
earlier in this section, for a description of the parameter. 

BEGIN,CCPLOAD,INSTALL,GN=zzz. 


CCPLOAD requires these input files. 


File _ Description 

AEXP Build parameters expand program. 

Ivvv CCP PICB load modules. 


PCMB 

UCCP 

USERBPS 

ZMUX 

ZSAM 


Updated combined program library. Refer to User-Supplied Files under 
CCP/CROSS Permanent Files, earlier in this section. 

Optional user corrective code. Refer to User-Supplied Files under 
CCP/CROSS Permanent Files, earlier in this section. 

CCP load file definitions file supplied by user. Refer to User-Supplied 
Files under CCP/CROSS Permanent Files, earlier in this section. 

MUX firmware and dump bootstrap overlay. 

SAM load module. 


Zvvv 


CCP variant load modules. 


CCPLOAD generates one output file. 

File Description 

Gzzz CCP load file (zzz is the value associated with the GN keyword). 

| If the released version of the NS job skeleton JOBNS is used (refer to the NAM5 
| section in this chapter), rename Gzzz file as NLFFILE and move NLFFILE to the 
| network administration user name. NLFFILE should be a direct access file with read 
| permission given to the network operations user name. 


1 
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CCPPURG - CCP/CROSS Installation Files Purge 

The following optional build step purges all the permanent files created by the 
CCP/CROSS installation process. This step does not purge the user-supplied files 
(USERCHG, USERBPS, UCCP, UCRS, and UEDZ associated with the variants in the 
build call), source PLs, or the CCP load file created by CCPLOAD (Gzzz). Refer to 
General Build Step Call, earlier in this section, for descriptions of the parameters. 

BEGIN,CCPPURG,INSTALL,VI=vvv1,...,Vn=vvvn. 

This step requires no input files and produces no output files. 

CCP System Definition 

The system definition controls the options and terminal interface programs (TIPs) that 
are assembled and compiled into the combined binary library (BCMB). It is similar to 
the variant definition (described in the following subsection), but must include all 
options and all TIPs that are used in any variants to be built from the resulting 
combined binary library. 

The system definition can continue over more than one line as long as each line prior 
to the last ends with a comma. The last line must end with a period. The system 
definition has two parts, either of which may be present or absent. The resulting four 
formats are as follows. 

Format Significance 

SYS. No options, no TIPs. 

SYS=<opt ions>. Options present, no TIPs. 

SYS,TS=<TIPs>. TIPs present, no options. 

SYS=<options>,TS=<TlPs>. Both options and TIPs present. 

Keyword Description 

SYS=vi/v2/v 3 Specifies options if present. 

vi Description 

C Support modules for CONSOLE (for printing CCP 

information on a terminal connected to a 2550) are 
compiled. 

D Online diagnostic support modules are present. 

P Support modules for statistics on line/trunk/NPU 

performance, which are logged in the account dayfile and 
the error log file, are compiled. 

R Remote concentrator products are present. 

T Support modules for the test utility program (TUP) and 

CONSOLE are compiled. (TUP is an unsupported product.) 
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Keyword Description 

TS=ti/.../tn Specifies which Terminal Interface Programs (TIPs) are to be 

included in the system. TS can assume up to 10 different 
order-independent values. 

ti Description 

A Asynchronous TIP is included. This TIP supports ASCII 

terminals, APL character sets, and IBM 2741 terminals. 

B Binary synchronous communications (BSC) TIP is included. 

This TIP supports the IBM 2780 and IBM 3780 terminals. 

H HASP TIP is included. 

M Mode 4 TIP is included. 

T 3270 TIP is included. 

XA X.25 TIP and application-to-application sub-TIP are included. 

XP X.25 TIP and PAD sub-TIP are included. Specify this TIP 

for any variant that executes in an NPU connected to a 
packet switching network. 

1 User TIPI is included. 

2 User TIP2 is included. 

3 User TIP3 is included. 

The following example includes all the options and TIPs specified in the examples 
shown for the variant load module definition. 

SYS=R/D/T,TS=A/B/H/M/XP/XA. 
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CCP Variant Load Module Definition 

The variant load module definition can continue over more than one line as long as 
each line prior to the last ends with comma. The last line must end with a period. 

The format follows: 

VRD=vvv,VT=v1/v2/v3,SZ=xK,TS=t1/.../tn. 

Keyword Description 

VRD = vvv Identifies entry as a variant definition and specifies variant name 

(associated vvv value). Build step CCP VAR uses vvv to create 
unique permanent file names. Specify a 3-character alphanumeric 
string, beginning with an alphabetic character. It must not be the 
same as the last 3 characters of the CCP/CROSS permanent file 
names (refer to CCP/CROSS Permanent Files, earlier in this 
section). 

VT = vi/v 2 /v 3 Specifies variant type of the NPU. You can associate a maximum 

of three separate values with VT. One of the following values 
must appear. 

vi Description 

F Front-end; includes Host Interface Program (HIP) but no 

Link Interface Program (LIP). 

L Local; includes HIP and LIP. 

R Remote; includes LIP but no HIP. 

The following values are optional. 

vi Description 

C Variant includes module CONSOLE. 

D Variant includes online diagnostic support modules. 

P Variant includes modules for statistics/performance results. 

T Variant includes modules TUP and CONSOLE for 

debugging. 


Examples: 


VT=L/D/T 


VT = F/D 
VT=R 
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Keyword _ Description 

SZ=xK Specifies variant memory size: 65K, 81K, 96K, or 128K (x is a 2- 

or 3-digit number). 

TS=ti/.../t n Specifies which Terminal Interface Programs (TIPs) are to be 

included in this variant. TS can assume up to 10 different 
order-independent values. 

ti Description 

A Asynchronous TIP is included. This TIP supports ASCII 

terminals, APL character sets and IBM 2741 terminals. 

B Binary synchronous communications (BSC) TIP is included. 

This TIP supports the IBM 2780 and IBM 3780 terminals. 

H HASP TIP is included. 

M Mode 4 TIP is included. 

T 3270 TIP is included. 

XA X.25 TIP and application-to-application sub-TIP are included. 

XP X.25 TIP and PAD sub-TIP are included. Specify this TIP 

for any variant that executes in an NPU connected to a 
packet switching network. 

1 User TIPI is included. 

2 User TIP2 is included. 

3 User TIP3 is included. 

Example 1: 

VRD=EX1,VT=L/D,SZ=81K,TS=A/M. 


This variant supports an 81K local NPU with asynchronous and mode 4 TIPs 
and online diagnostics. 

Example 2: 

VRD=EX2,VT=R/C,SZ=96K,TS=A/H/XP. 

This variant supports a 96K remote NPU with HASP, X.25 PAD, and 
asynchronous TIPs. This variant does not support online diagnostics but 
supports a 2550 console. 

Example 3: 

VRD=EX3,VT=F/D/T,SZ=128K,TS=A/B/H/M/XP/XA. 

This variant supports a 128K front-end NPU with no remote NPUs, all TIPs 
(except site-defined TIPs), and online diagnostics. This variant supports a 2550 
console. 
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CCP Load File Definition 

The format follows: 

LFD=ZZZ,LM=vvv1/.. ,/wvn. 

Keyword . Description 

LFD — zzz 


LM = vvvi 


Example 1: 

LFD=EX4,LM=EX1/EX2/EX3. 

This entry defines a load file containing the variants created in the three CCP 
variant definition examples. 

Example 2: 

LFD=EX5,LM=EX3. 

This entry defines a load file containing only the variant in the third CCP 
variant definition example. 

CCP Extra PLs Definition 

The format follows: 

PLS=ppp1/.../pppn. 

Keyword Description 

PLS=pppi Identifies entry as an extra PL definition and specifies which 

user-supplied PLs should be merged into PCMB. The parameter pppi 
is the name of the file to be merged with CCP. This entry is used by 
the CCPPH1 step. 


Identifies entry as a load file definition and specifies the last 
3 characters of the load file name (associated zzz value). The zzz 
value must be a 3-character alphanumeric string matching the 
corresponding GN = zzz parameter in the build step CCPLOAD. 
CCPLOAD uses this value to create a unique permanent file 
name for the output file, zzz must not be the same as the last 3 
characters of any of the CCP/CROSS permanent file names (refer 
to CCP/CROSS Permanent Files, earlier in this section). 

Specifies the CCP variant load modules and PICB load modules to 
include in this load file. The MUX firmware (phase 1), dump 
load, dump bootstrap, and SAM modules are automatically 
included in every load file. The associated value vvvi is the 
3-character name of a variant load module (file name Zvvvi) that 
was generated by the CCPVAR build step. Repeat the vwi 
specification (separated by slants) for each variant to be included 
in the load file. 
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CCP/CROSS Installation Examples 

Examples follow which illustrate installation of CCP in two network configurations: 
three NPUs (two local NPUs and one remote NPU) and a multihost configuration with 
three hosts, two NPUs, and an X.25 line. 

• All examples may use the following input files. 

Files Description 

UCCP Required for user-suggested or PSR code for CCP. 

UCRS Required for user-suggested or PSR code for CROSS. 

USERBPS Required for CCPBLB, CCPVAR and CCPLOAD; contains CCP 
system definitions, variant definitions and load file definitions. 

• In the build steps, all examples use the defaults for auxiliary pack device type 
and inclusion/exclusion of corrective code. 

• In all examples, underlined and lettered parameters indicate the interdependence 
among USERBPS definitions, EQPDECK entries, NDL source input, and build 
steps. Parameters with the same letter must match within each example. 

Example 1: Three NPUs 

Figure 7-4 illustrates the configuration of the network for this example. It shows the 
size of each NPU, the external connections (trunks, lines, and/or coupler) to each 
NPU, and the interface programs (TIPs and HIP and/or LIP) included in each NPU. 

It also shows the node number and port assignments and/or NDL name for major 
components in the network as chosen for this example. In the configuration shown in 
figure 7-4, the following conditions apply: 

• NPUA has three TIPs, a HIP, and a LIP. The latter two programs are required 
for the coupler and trunk, respectively. 

• NPUB has two TIPs as well as a HIP and a LIP. 

• NPUC has three TIPs and a LIP. A HIP is not required since no coupler is used. 

NPUA and NPUC have online diagnostics; NPUC has console support. NPUC can 
communicate with the network through the remote node software of either NPUA or 
NPUB. 

The following procedure illustrates the installation of CCP with a network 
configuration as shown in figure 7-4. 

1. Ensure that the required files and tapes are available. Refer to figure 7-5 for 
appropriate USERBPS definitions, EQPDECK entries, and NDL source input. 

2. Install CROSS. 

BEGIN,CROSS.INSTALL. 

This step requires CRSSpsrin and a field length of 110K. 
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3. Build the phase 1 (microcode and dump bootstrap) and SAM load modules. 

BEGIN,CCPPH1,INSTALL,CCPLI$T=PF,DIAG=YES,REMT=YES. 

This step requires CCPBpsrin, CCPDpsrin, and CCPRpsrin. CCPLIST=PF stores 
the listings on disk as permanent files; DIAG=YES specifies that online 
diagnostics are present; REMT = YES specifies that remote concentrator products 
are present. 

4. Create an updated combined binary library of all CCP Pascal procedures and 
assembly language subroutines. 

BEGIN,CCPBLB,INSTALL,CCPLIST=BOTH,XREF=YES. 

This step requires CCPBpsrin. CCPLIST = BOTH routes the listings to the printer 
and stores them as permanent files during the installation procedure. At the end 
of the procedure, the files are copied to the new release file and purged. 

XREF = YES generates a Pascal cross-reference listing. 

5. Create the phase 2 variant load module for NPUA. 

a 

BEGIN,CCPVAR,INSTALL,VARLIST=PF,VN=VNA. 

VARLIST=PF stores the listings as permanent files during the installation 
procedure. At the end of the procedure, the files are copied to the new release file 
and purged. The load module file name is ZVNA, and the PICB file name is 
IVNA. 
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Figure 7-4, Network Configuration - Example 1 
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6. Create the phase 2 variant load module for NPUB. 

b 

BEGIN,CCPVAR,INSTALL,VN=VNB. 

The load module file name is ZVNB and the PICB file name is IVNB. 

7. Create the phase 2 variant load module for NPUC. 

BEGIN,CCPVAR,INSTALL,VARLIST=PF,VN=RMC. 

The load module file name is ZRMC and the PICB file name is IRMC. 
VARLIST=PF stores the listings as permanent files during the installation 
procedure. At the end of the procedure, the files are copied to the new release file 
and purged. 

8. Create the load file used by NAM/NS to downline load the NPUs. 

n 

BEGIN,CCPLOAD,INSTALL,GN=EX3. 

The load file name is GEX3. 

9. Execute this build step only if you want to purge all permanent files created by the 
CCP/CROSS installation process. 

a b c 

BEGIN,CCPPURG,INSTALL,VI=VNA,V2=VNB,V3=RMC. 
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•USERBPS 

•THREE-NPU EXAMPLE 
* 

•SYSTEM DEFINITION IS 
* 

• edf g h i j k 

SYS=R/D/C,TS=A/B/H/M/XP. 

* 

•VARIANT DEFINITIONS ARE 
* 

•a e d g i k 

VRD=VNA,VT=L/D,SZ=128K,TS=A/H/XP. 

•be j i 

VRD=VNB, VT=L, SZ=96K, TS=M/H .» USERBPS 

* c edf jhk Definitions 

VRD=RMC,VT=R/D/C,SZ=96K,TS=M/B/XP. 

* 

•LOAD FILE DEFINITION IS 
* 

* n a b c 
LFD=EX3,LM=VNA/VNB/RMC. 

NCF2P1: NFILE. 

a 

NPUA: NPU NODE=4, VARIANT=VNA. 

SUPLINK LLNAME-LL24. 

C0UP2: COUPLER NODE=2,HNAME =HOST1. 

LL24: LOGLINK NCNAME=NPUA. 

LL26: LOGLINK NCNAME=NPUC. 

b 

NPUB: NPU NODE =5, VARIANT=VNB. NDL 

Source 

SUPLINK LLNAME=LL35. INPUT 

C0UP3: COUPLER NODE=3. HNAME=HOST1. 

LL35: LOGLINK NCNAME=NPUB. 

LL36: LOGLINK NCNAME=NPUC. 


Figure 7-5. 


USERBPS Definitions, NDL Source Input, and EQPDECK Entries 
for Example 1 


( Continued) 
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(Continued) 


c 

NPUC: NPU NODE=6, VARIANT=RMC. 


SUPLINK LLNAME-LL26. 


SUPLINK LLNAME=LL36. 


TRUNK26:TRUNK N1=NPUA,N2=NPUC,P1=1,P2=1. 


TRUNK36:TRUNK N1=NPUB,N2=NPUC,P1=1,P2=2. 

END. 


EQ41=NP,ST=ON,EQ=7,PI=1,CH=5,ND=2,SA=0FF. 

EQ42=NP,ST=ON,EQ=7,PI = 1,CH=5,ND=3,SA=0FF. 

EQPDECK 

Entries 


Figure 7-5. USERBPS Definitions, NDL Source Input, and EQPDECK Entries 

for Example 1 
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Example 2: Three Hosts, Two NPUs, X.25 Line 

Figure 7-6 illustrates the configuration of the network for this example. It shows the 
size of each NPU, the external connections (trunks and couplers) to each NPU, and 
the interface programs (TIPs, HIP, and LIP) included in each NPU. It also shows the 
node number and port assignments and/or NDL names for major components in the 
network as chosen for this example. In the configuration shown in figure 7-6, the 
following conditions apply: 

• NPUA has four TIPs, a HIP, and an X.25 line. The latter two programs are 
required for the coupler and trunk respectively. 

• NPUB has three TIPs, a HIP, and an X.25 line. The latter two programs are 
required for the coupler and trunk respectively. 

• HOST1 has NS only. 

• HOST2 has CS only. 

• HOST3 has NS and CS. 

• PTF and QTF are installed on all three hosts. 

• Host-to-host and host-to-NPU (X.25) are defined for PTF/QTF transfers. 

NPUA has the performance statistics package and console support. NPUB has online 
diagnostics. NPUA and NPUB can communicate with all three hosts in the network. 

The following procedure illustrates the installation of CCP with a network 
configuration as shown in figure 7-6. 

1. Ensure that the required files and tapes are available. Refer to figure 7-7 for the 
appropriate USERBPS definitions, NDL source input, and EQPDECK entries. 

2. Follow steps 2 through 6 in example 1. 

3. Create the load file used by NAM/NS to downline load the NPUs. 

n 

BEGIN,CCPLOAD,INSTALL,GN=EX4. 

The load file name is GEX4. 

4. Execute this build step only if you want to purge all permanent files created by 
the CCP/CROSS installation process. 


a b 

BEGIN,CCPPURG,INSTALL,V1=VNA,V2=VNB. 
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Figure 7-6. Network Configuration - Example 2 
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* USERBPS 

* TWO-NPU, THREE-HOST EXAMPLE. 

* SYSTEM DEFINITION. 

* SYSTEM INCLUDES: 

* C CONSOLE 

* D DIAGNOSTICS 

* P PERFORMANCE 

* R REMOTE 

* TIPS PRESENT ARE: 

* A ASYNC 

* B BISYNC 2780-3780 

* H HASP 

* M M0DE4 

* XA X25 A TO A USERBPS 

* XP X25 PAD Definitions 

* cde ghijkm 
SYS=C/D/P,TS=A/B/H/M/XA/XP. 

* VARIANT DEFINITIONS 

* NPU A 

* a ce ghjkm 

*VRD=VNA.VT=C/F/P,SZ=128K,TS=A/B/M/XA/XP. 

* NPU B 

* b d g i j k 

*VRD=VNB,VT=D/F,SZ=128K,TS=A/H/M/XA. 


* LOAD FILE DEFINITION 

* 

* n a b 
LFD=EX4,LM=VNA/VNB. 


Figure 7-7. 


USERBPS Definitions, NDL Source Input and EQPDECK Entries for 

Example 2 


( Continued) 


Revision L 


Special Product Installation Information 7-51 








CCP - CYBER CROSS System and Communications Control Program 


(Continued) _ __ 

NCF2P2:NFILE. ~ 

a 

NPUA:NPU NODE=5, VARIANT=VNA. 

SUPLINK LLNAME=LL35. 

SUPLINK LLNAME=LL25. 

COUP2: COUPLER NODE=2, HNAME=HOST1. 

LL23: LOGLINK NCNAME=COUP3. 

LL25: LOGLINK NCNAME=NPUA. 

COUP3: COUPLER NODE=3, HNAME=HOST2. 

LL32: LOGLINK NCNAME=COUP2. 

LL35: LOGLINK NCNAME=NPUA. 

L08 :LINE PORT=8 LTYPE=H1, 

TIPTYPE=X25,DFL=128, 

FRAME=7,RTIME=3000,RCOUNT=15, 

PSN=TYMNET,NSVC=16,DCE. 

T08 :TERMDEV W=2 f NCIR=16, 

NEN=16,STIP=XAA. 

NDL 
Source 
Input 


END. 


b 

NPUBrNPU NODE=6, VARIANT=VNB. 

SUPLINK LLNAME=LL46. 

C0UP4: COUPLER N0DE=4, HNAME=HOST3. 
LL46: LOGLINK NCNAME=NPUB. 

L09 :LINE P0RT=9,LTYPE=H1, 
TIPTYPE=X25,DFL=128, 

FRAME=7,RTIME=3000, 

RCOUNT=15,PSN=TYMNET, 
NSVC=16. 

T09 :TERMDEV W=2,NCIR=16, 

NEN=16,STIP=XAA. 


Figure 7-7. 


USERBPS Definitions, NDL Source Input and EQPDECK Entries for 

Example 2 


(Continued) 
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(Continued) _ 

LCf FILE: LFILE. 

TITLE LCF FOR HOST 1 


«* 

* APPLICATION DEFINITIONS FOR HOST 1 

** 

IAF :APPL,PRIV. 

RBF :APPL,PRIV,UID. 

ITF :APPL,PRIV. 

QTF :APPL,PRU,NETXFR,PRIV. 

QTFS :APPL,MXCOPYS=10,RS,PRU,NETXFR,PRIV. 

PTF :APPL,MXCOPYS-6,PRU,NETXFR,PRIV. 

PTFS :APPL,MXCOPYS=10,RS,PRU,NETXFR,PRIV. 


* INCALL/OUTCALL BLOCKS FOR HOST 1 

* 

* * 

INCALL,FAM=0,UNAME=netopun,ANAME=QTFS,DBL=7,ABL=7,DBZ=1024. 

OUTCALL,NAME 1=QTFS,PID=M02,SNODE=2.DNODE=3,DBL=7,ABL=7,DBZ=1024. 

INCALL,FAM=0,UNAME=netOPUn,ANAME=PTFS,DBL=7,ABL=7,DBZ=1024. 

OUTCALL,NAME 1=PTFS,PID=M02,SNODE=2,DN0DE=3,DBL=7,ABL=7,DBZ=1024. 

INCALL,FAM=0,UNAME=netopun,ANAME=QTFS,PORT=8,SNODE=5,DNODE=2,DBZ=1024,DBL=7, 
ABL=7,UBZ=1024,UBL=7,WS=7,DPLS=1024. 

OUTCALL,NAME 1=QTFS,PID=M03,SNODE=2,DNODE =5,SHOST=2D3033,PORT=8,DH0ST=4, 
DBZ=1024,DBL=7,ABL=7,UBZ=1024,UBL=7,WS=7,DPLS=1024. 

INCALL,FAM=0,UNAME=netopun,ANAME=PTFS,PORT=8,SNODE=5,DNODE=2,DBZ=1024,DBL=7, 
ABL=7,UBZ=1024,UBL=7,WS=7,DPLS=1024. 

OUTCALL,NAME 1=PTFS,PID=M03,SNODE =2,DNODE=5,SHOST=2D3033,PORT=8,DH0ST=4, 
DBZ=1024,DBL=7,ABL=7,UBZ=1024,UBL=7,WS=7,DPLS=1024. 


Figure 7-7. 


USERBPS Definitions, NDL Source Input and EQPDECK Entries for 

Example 2 


(Continued) 
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LCFFILE:LFILE. 

TITLE LCFFILE FOR HOST 2 


** 

* 

* APPLICATION DEFINITIONS FOR HOST 2 

* * 

IAF :APPL,PRIV. 

RBF :APPL,PRIV.UID. 

ITF :APPL,PRIV. 

QTF :APPL, PRU,NETXFR,PRIV. 

QTFS :APPL,MXCOPYS=10,RS,PRU,NETXFR,PRIV. 

PTF :APPL,MXCOPYS=6,PRU,NETXFR,PRIV. 

PTFS :APPL,MXCOPYS=10,RS,PRU,NETXFR,PRIV. 

** 

* 

* INCALL/OUTCALL BLOCKS FOR HOST 2 


** 


INCALL,FAM=0,UNAME=netopun,ANAME=QTFS,DBL=7,ABL=7,DBZ=1024. 

OUTCALL,NAME 1=QTFS,PID=M01,SNODE =3,DNODE=2,DBL=7,ABL=7,DBZ=1024. 

INCALL,FAM=0,UNAME=netopun,ANAME=PTFS,DBL=7,ABL=7,DBZ=1024. 

OUTCALL, NAME 1 =PTFS, PID=M01, SNODE =3, DNODE=2, DBL=7, ABL=7, DBZ= 1024 . 
INCALL,FAM=0,UNAME=netopun,ANAME=QTFS,P0RT=8,SN0DE=5,DN0DE=3,DBZ=1024,DBL=7, 
ABL=7,UBZ=1024,UBL=7,WS=7,DPLS=1024. 

OUTCALL,NAME 1=QTFS,PID=M03,SN0DE=3,DN0DE=5,SHOST=2D3033,PORT=8,DH0ST=4, 

DBZ=1024,DBL=7,ABL=7,UBZ=1024,UBL=7,WS=7,0PLS=1024. 

INCALL,FAM=0,UNAME=netopun,ANAME=PTFS,PORT=8,SNODE =5,DNODE=3,DBZ=1024,DBL=7, 
ABL=7,UBZ=1024,UBL=7,WS=7,DPLS=1024. 

OUTCALL,NAME 1=PTFS,PID=M03,SNODE=3,DNODE=5,SHOST=2D3033,PORT=8,DH0ST=4, 

DBZ=1024,DBL=7,ABL=7,UBZ=1024,UBL=7,WS=7,DPLS=1024. 


Figure 7-7. 


USERBPS Definitions, NDL Source Input and EQPDECK Entries for 

Example 2 


(Continued) 
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LCFFFILE:LFILE 

TITLE LCFFILE FOR HOST 3 


* 

APPLICATION DEFINITIONS FOR HOST 3 


IAF :APPL.PRIV. 

RBF :APPL.UID.PRIV. 

ITF :APPL.PRIV. 

QTF :APPL,PRU,NETXFR,PRIV. 

QTFS :APPL,MXCOPYS=10,RS.PRU,NETXFR,PRIV. 

PTF :APPL,MXC0PYS=6,PRU,NETXF2,PRIV. 

PTFS :APPL,MXCOPYS=10,RS.PRU,NETXFR,PRIV. 


* INCALL/OUTCALL BLOCKS FOR HOST 3 

* 

** 


INCALL,FAM=0.UNAME=netopun,ANAME=QTFS,PORT=9,SN0DE=6,DN0DE=4,DBZ=1024,DBL=7, 

ABL=7,UBZ=1024,UBL=7,WS=7,DPLS=1024. 

OUTCALL,NAME1=QTFS,PID=M01,SNODE =4,DNODE =6,SHOST=2D3031.P0RT=9,0H0ST=2. 

DBZ=1024,DBL=7,ABL=7,UBZ=1024,UBL=7,WS=7,DPLS=1024. 

INCALL,FAM=0,UNAME=netopun,ANAME=PTFS,P0RT=9,SN0DE=6.DNODE=4,DBZ=1024,DBL=7, 

ABL=7,UBZ=1024,UBL=7,WS=7,DPLS=1024. 

OUTCALL,NAME 1=PTFS,PID=M01.SNODE=4,DNODE =6,SHOST=2D3031,PORT=9.DHOST=2, 

DBZ=1024,DBL=7,ABL=7,UBZ=1024,UBL=7,WS=7,DPLS=1024. 

OUTCALL,NAME 1=QTFS,PID=M02,SNODE=4,DNODE =6,SH0ST=2D3032,PORT=9,DH0ST=3. 

DBZ=1024,DBL=7.ABL=7,UBZ=1024.UBL=7,WS=7,DPLS=1024. 

OUTCALL,NAME 1=PTFS,PID=M02,SN0DE=4.DNODE =6.SHOST=2D3032,P0RT=9,DH0ST=3, 

DBZ=1024,DBL=7,ABL=7,UBZ=1024,UBL=7,WS=7.DPLS=1024. 

EQ41=NP,ST=ON,EQ=7,PI=1,CH=5,ND=2,SA=OFF. COUPLER 2 FOR HOST 1 

EQ42=NP,ST=ON,EQ=7,PI=1,CH=5,ND=3,SA=OFF. COUPLER 3 FOR HOST 2 EQPDECK Entries 

EQ42=NP,ST=ON,EQ=7,PI=1,CH=5,ND=4,SA=0FF. COUPLER 4 FOR HOST 3 


Figure 7-7. USERBPS Definitions, NDL Source Input and EQPDECK Entries for 

Example 2 
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CDCNET - Control Data Distributed Communications 
Network 

This section describes how to install and configure CDCNET. CDCNET is composed of 
two subproducts: DCNS and CHA1. DCNS is a binary-supported product that consists of 
the ANACD, DI, MANCC, and NPA software. It is updated through a CDCNET Batch 
Critical Update (BCU), which is described in chapter 5. CHAl consists of the NAM 
applications and utilities that interface with the DCNS software. 

NOTE _ 

CDCNET and its separately priced TIPs are supported in 64-character set only. 


General CDCNET information is documented in the following subsections: 

• Configuration Information 

• Installing CDCNET for the First Time 

• Upgrading CDCNET 

• Activating a New Level of CDCNET 

• Installing a CDCNET Separate TIP 

• Installing CDCNET for MDI Reset Support Only 

• Installation Wrapup Activities 

• NPA Database Maintenance 

Information relating to the CHAl portion of the CDCNET software is documented in 
the following subsections: 

• CDCNET Host Application (CHAl) Product Content 

• Unique Parameters 

• USER File Directives 

• Installation Parameters 

• Message Templates 

• NAM Startup Procedure File Changes 

• CDCNET Network Host Application Program Requirements 

• Network Definition Language (NDL) Requirements 
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Configuration Information 

• CDCNET Configuration Files and Procedures. CDCNET uses several different 
types of configuration files and procedures: 

“ Device Interface (DI) system configuration procedures define the hardware and 
software attributes of the different types of DIs. 

- Terminal User Procedures (TUPs), Terminal Definition Procedures (TDPs), and 
Load Procedures (LPs) are used to specify additional information about lines 
and terminal and batch devices in addition to the information specified in the 
system configuration procedures. 

- Exception List file controls the loading of non-host-resident DIs. Loading of 
host-resident DIs is controlled by the INITDCN NOS permanent file. 

The DI system configuration procedures, TDPs, TUPs and LPs can be maintained 
in individual files or libraries. Refer to the CDCNET Configuration and Site 
Administration Guide for more information. 

During permanent file installation, SYSGEN automatically creates configuration 
files that allow you to load and configure a DI and log in to a terminal for 
completing installation. 

All CDCNET configuration files reside on the network administration user name 
except for the network directory file (NETDIR) which resides on the network 
operations user name. You can log in to the network administration user name to 
perform the configuration of CDCNET. The user name has been given write 
permission to the NETDIR file on the network operations user name. This 
permission allows you to update this file from an interactive terminal. 

For more information on configuring CDCNET, refer to the CDCNET 
Configuration and Site Administration Guide. 

• Local Configuration File. The LCF portion of the NDL defines the applications 
(with APPL statements) that allow CDCNET to interface to NAM. INCALL 
statements define the connections between the DI software and the NAM 
applications. The required statements are in the released sample NDL file named 
NDLDATA. The statements are documented in Network Definition Language 
Requirements later in this section. For information on compiling a new NDL, 
refer to the NAM5 section of this chapter. 

• EQ EQPDECK entry for CDCNET. This entry defines the connection of each 
Mainframe Device Interface (MDI) or Mainframe Terminal Interface (MTI) to the 
mainframe. Optionally, the ND and NT parameters are referenced in CDCNET DI 
configuration files. For more information about the EQ EQPDECK entry for 
CDCNET, refer to the Deadstart Deck section of the NOS Version 2 Analysis 
Handbook. 
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Installing CDCNET for the First Time 

Perform the following instructions if you are installing CDCNET for the first time as 
part of an upgrade or component order installation. 1 One step is performed from the 
system console and the rest of the steps are performed from an interactive terminal. 

Before beginning the steps below, make sure that the network administration user 
name has been created. Also, have the permanent file tapes available for mounting. 

The values insun, netopun, and netadun should be substituted throughout the 
following steps with the user names that the site is using for the installation user 
name, network operations user name, and the network administration user name, 
respectively. If you wish to use the Control Data default values, replace insun with 
INSTALL, netopun with NETOPS, and netadun with NETADMN. 

1. Install CDCNET files to the installation user name. 

a. Log in to IAF under the installation user name. If you are installing CDCNET 
as part of a component order, skip step b. 

b. Make the newly released SYSGEN procedures local to your job by entering: 

GET.SYSGEN. 

c. Load CDCNET permanent files from the permanent file tape by entering: 

SYSGEN,RECLAIM,PFGDCNS,PFGCHA1. 

The permanent file tapes are requested. 

d. If you are not changing the default installation user name, network operations 
user name, or the network administration user name, skip to step e. To 
change these user names, enter the following command: 

BEGIN,CHASUN,PFGDCNS,1nsun,netopun,netadun. 

Replace insun with the installation user name, netopun with the network 
operations user name, and netadun with the network administration user 
name. By default, these user names are INSTALL, NETOPS, and NETADMN, 
respectively. 

If you changed the network administration user name from NETADMN, a local 
file named LGO will be created. This contains updated versions of procedures 
MANCC, ANACD, and NPA; that is, these procedures will access files from 
the new network administration user name. File LGO must be LIBEDITed into 
files GLOBLIB and PRODUCT. LIBEDITing into GLOBLIB ensures that an 
analyst using these procedures gets files from the new user name. LIBEDITing 
into PRODUCT ensures that the new deadstart tape will contain the updated 
versions. 

e. Create the CDCNET installation procedure file by entering: 

BEGIN,INSPL,PFGDCNS. 


1. If you are installing CDCNET in a multihost network, refer to Installing CDCNET for MDI Reset Support 
Only, later in this section. 
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f. Load the CHA1 message template file, HTF_id_psrout (where id = A, 
psrout = NOS release level) to disk on the installation user name by entering: 

BEGIN,INITIAL,DCNPLIB,INSTALL. 

A message is displayed at your terminal indicating the version level of 
CDCNET being installed. 

g. Log out of the installation user name. 

2. Create the network directory file (NETDIR) on the network operations user name 
by performing these steps from the system console. 

a. Enter these commands: 

X.DIS. 

USER,netopun,password. 

ATTACH,DCNPLIB/UN=insun. 

BEGIN,INITIAL,DCNPLIB,netopun. 

b. The network administration user name is given access to the directory. Once 
this procedure completes, enter: 

DROP. 

3. Load CDCNET files to the network administration user name by performing the 
following steps from an interactive terminal: 

a. Log in to IAF under the network administration user name. 

b. Enter the following commands: 

ATTACH,DCNPLIB/UN=insun. 

BEGIN,INITIAL,DCNPLIB,netadun. 

This step requests the permanent file tapes, loads all DCNS software to disk 
(including configuration files), and initializes the NPA databases. A message is 
displayed to indicate the version level of CDCNET being installed. This step 
also displays NETFM output as the CDCNET files are added to the directory. 
Check the NETFM output on the screen to ensure that all CREATE directives 
completed normally. When the procedure completes, all new CDCNET software 
files have been loaded to the network administration user name. 

4. Define the system ID of the MDI or MTI connected to your mainframe using the 
procedure ADDDI (ADD_DEVICE_INTERFACE). If you are not executing this 
step from the same terminal session as step 3, log in to the network 
administration user name and execute the commands below to access the 
installation tools required in file GLOBLIB on the installation user name: 

ATTACH,GLOBLIB/UN=insun. 

LIBRARY,GLOBLIB/A. 

You can now use NETPLM, NETFM, MANCC, and so forth, for configuring 
CDCNET. 
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a. Define the system IDs for each DI in the network using procedure ADDDI 
(ADD_DEVICE_INTERFACE). Enter the following commands from an 
interactive terminal logged in to the network administration user name: 

BEGIN,ADDDI,DCNPLIB,type,Si. 

Parameter Description 

type Type of DI (MDI or MTI). 

si Last six digits of the DI’s system identifier. The DI 

system identifier is a 12-digit number printed on a tag 
attached to the inside of the DI cabinet. Note that the tag 
contains a 4-digit checksum appended to the 12-digit 
system identifier. Do not include the checksum in this 
parameter. 

Check the NETPLM output on the screen to be sure the configuration file is 
successfully added to the network directory file. 

If you configured an MTI in step a, skip step b. 

b. Repeat the ADDDI procedure call for each TDI you define. Specify the DI’s 
system identifier (si): 

BEGIN,ADDDI,DCNPLIB,TDI,si. 

After completing the procedures described in this section, refer to the CDCNET 
Configuration and Site Administration Guide to modify configuration files for your site. 
GLOBLIB must be available in order to use NETPLM, NETFM, MANCC, and so forth. 

Upgrading CDCNET 

If you are installing CDCNET in a multihost network, refer to Installing CDCNET for 
MDI Reset Support Only, later in this section. 

The values insun, netopun, and netadun should be substituted throughout the 
following steps with the user names that the site is using for the installation user 
name, network operations user name, and the network administration user name, 
respectively. If you wish to use the Control Data default values', replace insun with 
INSTALL, netopun with NETOPS, and netadun with NETADMN. 

NOTE 


If you are changing the default Control Data installation user names (in particular, 
NETOPS and NETADMN), note the following: 

• If you change the network operations user name: 

1. Move the network directory file NETDIR to the new user name and update its 
permissions, if any. 

2. Update the file permissions of the files on user name NETADMN (for example, 
ELIST) to give READ permission to the new user name. (If you are also 

. changing the network administration user name, update the file permissions 
after moving the files from NETADMN.) 
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• If you change the network administration user name: 

1. Move all files currently on NETADMN to the new user name. 

2. Update the directory entries for these NETADMN files to specify the new user 
name. For example, to update the directory for file ELIST, execute the 
following commands from the network administration user name: 

NETFM,UN=netOpun,Z./DELETE,PF=ELIST,NF=EXCEPTION_LIST,UN=NETADMN 
NETFM,UN=netopun,Z./CREATE,PF=ELIST,NF=EXCEPTION_LIST 

A similar pair of commands should be executed for each file that is listed in 
the network directory. 


1. Install CDCNET files to the installation user name. 

a. Log in to IAF under the installation user name. 

b. Make the newly released SYSGEN procedures local to your job by entering: 

GET,$YSGEN. 

c. Load CDCNET permanent files from the permanent file tape by entering: 

SYSGEN,RECLAIM,PFGDCNS,PFGCHA1. 

The permanent file tapes are requested. 

d. If you are not changing the default installation user name, network operations 
user name, or the network administration user name, skip to step e. To 
change these user names, enter the following command: 

BEGIN,CHASUN,PFGDCNS,insun,netopun,netadun. 

Replace insun with the installation user name, netopun with the network 
operations user name, and netadun with the network administration user 
name. By default, these user names are INSTALL, NETOPS, and NETADMN, 
respectively. 

If you changed the network administration user name from NETADMN, a local 
file named LGO will be created. This contains updated versions of procedures 
MANCC, ANACD, and NPA; that is, these procedures will access files from 
the new network administration user name. File LGO must be LIBEDITed into 
files GLOBLIB and PRODUCT. LIBEDITing into GLOBLIB ensures that an 
analyst using these procedures gets files from the new user name. LIBEDITing 
into PRODUCT ensures that the new deadstart tape will contain the updated 
versions. 

e. Create the CDCNET installation procedure file by entering: 

BEGIN,INSPL,PFGDCNS. 
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f. Load the CHAl message template file, HTF_id_psrout (where id=A, 
psrout=NOS release level) to disk on the installation user name by entering: 

BEGIN,UPGRADE,DCNPLIB,insun. 

A message is displayed at your terminal indicating the version level of 
CDCNET being installed. 

g. Log out of the installation user name. 

2. Load CDCNET files to the network administration user name. Perform the 
following steps from an interactive terminal: 

a. Log in to IAF under the network administration user name. 

b. Enter the following commands: 

ATTACH,DCNPLIB/UN=insun. 

BEGIN,UPGRADE,DCNPLIB,netadun. 

This step requests the permanent file tapes and loads DCNS software to disk. 

A message is displayed to indicate the version level of CDCNET being 
installed. This step also displays NETFM output as the CDCNET files are 
added to the directory. Check the NETFM output on the screen to ensure that 
all CREATE directives complete normally. When the procedure completes, all 
new CDCNET software files have been loaded to the network administration 
user name. Note that no site-modifiable configuration files are loaded. 

You have completed installing the new level of CDCNET software. The instructions in 
chapter 3 will direct you back to this section when it is time to activate a new 
CDCNET and perform wrapup activities. 
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Activating a New Level of CDCNET 

If you installed CDCNET for MDI Reset Support Only, there is no need to activate the 
new level of CDCNET because there is no CDCNET software to load. 

When a new version of BCU for CDCNET is installed, the version level changes. The 
version level is included in all released CDCNET software files except site-controlled 
configuration files. Version levels in the file names allow multiple versions of 
CDCNET to reside together on disk under one user name. 

The version level of the components of CDCNET are controlled in two places: in the 
INITDCN procedure (stored in file INITDCN on the network administration user 
name) and in the exception list (file ELIST on the network administration user 
name). The exception list maintains the default version level for all 
non-host-connected DIs; INITDCN maintains the levels for all other components. 

To update the version level, use the SETVL (SET_VERSION_LEVEL) procedure. 
Execute this procedure from the network administration user name: 

BEGIN,SETVL,DCNPLIB,T00L=tOOl,V=vvvv,ID=id. 

Parameter Description 

TOOL=tool The name of the component to update. Allowable values are: 

ANACD, ELIST, INMD, MANCC, NETOU, NPA, and ALL. 

INMD refers to the boot file level INITMDI loads into all 
host-connected DIs, ELIST refers to the exception list, and ALL 
updates all the tools. 

V = vvvv The version level of CDCNET you wish to activate. 

ID = id The 1-character identifier for the CHAl template file. The id 

character for the release template is A. This parameter is 
required for TOOL=NETOU and TOOL = ALL. 

It is recommended that TOOL=ALL be used for an upgrade or BCU installation. Once 
SETVL has completed, all future load requests for DIs and all accesses for ANACD, 
MANCC, and NPA use vvvv level software; the next initiation of NETOU uses 
template file TF_id_vvvv. 

NOTE 


For this procedure to properly process the exception list, the permanent file name 
must be ELIST, and the DEFBD (DEFINE_BOOT_DEFAULTS) command must 
specify the software version level with the text DV = vvvv(16). DV = vvvv(16) must 
be on one line. SETVL does not set the boot default for specific DIs that are handled 
in the exception list. 


Installing a CDCNET Separate TIP 

If you are installing CDCNET for the first time as part of a component order, follow 
the instructions in chapter 4. However, if you are adding a CDCNET separate 
Terminal Interface Program (TIP) in a component order, use the following instructions 
rather than the instructions in chapter 4: 

1. Log in to the installation user name from an interactive terminal. 
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2. Execute the following command: 

RECLAIM,2./DELETE,UN=NS2psr1n,PF=*/PFGNDL1,PFGCHA1,PFGCHA2,PFGDCNS 

This command deletes these files from the database. (The files are still there, but 
they are not processed during normal operations.) 

3. Update the RECLAIM database with information about the files on the component 
order tape by entering: 

SYSGEN,UPGRADE,0,0,vsn,density. 

Replace vsn with the VSN of the CDC supplied component order tape. (The VSN 
is listed in the media number field of the external tape label.) Replace density 
with the tape density of the permanent file tape (HY, HD, PE, or GE). 

4. Log in to the network administration user name from an interactive terminal. 

5. Execute the following command: 

BEGIN,UPGRADE,DCNPLIB,netadun. 

This command requests the permanent file tape and updates the files on the 
network administration user name. Since the CDCNET version level is the same 
as the original release level of CDCNET, the existing files whose names contain 
the CDCNET version level are overwritten. The only file modified is the CDCNET 
object library file L70vvvv, where vvvv represents the CDCNET version level. 

Installation of the software is complete. You must now alter your DI configuration 
procedures to configure in the separate TIP. Consult the CDCNET Configuration and 
Site Administration Guide for details. 


Installing CDCNET for MDI Reset Support Only 

It may be desirable in a multihost network to manage all CDCNET software from a 
single mainframe. In this environment, CDCNET should be configured so that all DIs 
are loaded from software residing on one mainframe. To support the failure 
management software in the MDI, a small set of CDCNET software is required on the 
other mainframes which will not be providing load support. Specifically, each of the 
NOS hosts must be able to run the INITMDI software which is contained in the CHA1 
portion of the CDCNET product. Installing this minimal portion of CDCNET results in 
a considerable saving in disk space. The instructions that follow describe how to install 
this minimal set of CDCNET software. Installation of a complete set of CDCNET 
software is described earlier in this section. 

| To execute these instructions, you must load the RECLAIM database to the 
| installation user name and create the network administration user name. Do this by 
I performing steps 1 and 2 in either chapter 3 or 4. 

.. NOTE 


| If you have CDCNET installed on your system and want to change it to support only 
| MDI resets, do not execute these instructions. Instead, purge all files on the network 
I administration user name, except for DCNPLIB, then execute the command 
I BEGIN,MDIONLY,DCNPLIB. 
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Enter these commands from the system console. 

1. Enter: 

X.DIS. 

USER,netadun,password. 

Replace netadun with the network administration user name and password with 
its password. 

2. Load the CDCNET permanent files from the permanent file tapes: 

SYSGEN,RECLAIM,PFGDCNS. 

3. Install file INITDCN, which is required by the INITMDI program, on the network 
administration user name: 

BEGIN,MDIONLY,PFGDCNS. 

DROP. 

4. During Step 5 of chapter 3 or 4, disable the loading of files PFGDCNS and 
PFGCHA2. File PFGCHA1 must be loaded to properly update the NAMSTRT file 
to contain the record JOBINMD and its associated JOB statement in the PARAM 
NAMSTRT records. This update is required to allow INITMDI to execute. Note 
that the installation of PFGCHA1 causes a number of other job records (NETLS, 
NETFS, and NETOU) to be added to NAMSTRT. These jobs are submitted when 
NAM is invoked, but since these applications are request startable, they will not 
execute at a control point or be in the rollout queue unless a load request is 
initiated for them by entries in the DI configuration file. 

5. During Step 7 of chapter 3 or 4, there is no need to activate the new level of 
CDCNET since there is no CDCNET software to load. 

Installation Wrapup Activities 

After you have upgraded CDCNET and the new version is running satisfactorily, 
remove earlier versions of the CDCNET software from disk to conserve disk space. The 
CLEANUP procedure purges software files from the network administration user name. 
Only files from the specified version level are removed. Boot files and object libraries 
are also removed from the network directory file NETDIR. 

To remove a version of CDCNET software, execute the following procedure call from 
the network administration user name: 

BEGIN,CLEANUP,DCNPLIB,V=vvvv. 

Replace vvvv with the version level of the CDCNET files you want to remove from 
disk. 

NPA Database Maintenance 

When CDCNET is first installed, the NPA databases are initialized to empty direct 
access permanent files on the network administration user name. By running the 
REFCLF (REFORMAT_CDCNET_LOG_FILE) program described in the NPA Reference 
Manual, these databases are updated from the log files stored on user name 
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SYSTEMX. The databases are manipulated and reports are generated by NPA Report 
which is also documented in the NPA Reference Manual. DCNPLIB contains procedure 
DB, which performs several functions on the databases and NPA database definition 
files. The procedure calls are described next. 

• BEGIN(DB,DCNPLIB,DEFINE). This procedure call creates the NPA database files 
if they do not already exist. Existing database files are not altered. This 
procedure does not affect database definition files (which are installed as part of 
NPA). 

• BEGIN(DB,DCNPLIB,PURGE). This procedure call purges the NPA databases. The 
database definition files are not affected. 

• BEGIN(DB,DCNPLIB,PERMIT,username). This procedure call permits the specified 
user name to have read access to NPA databases and database definition files. 
Permits are controlled with the standard NOS PERMIT command. The parameter 
username is any valid NOS user name. 

• BEGIN(DB,DCNPLIB,DEPERMIT,username). This procedure call prevents the 
specified user name from accessing NPA databases and database definition files by 
removing it from the permit list for each database. Permits are controlled with 
the standard NOS PERMIT command. The parameter username is any valid NOS 
user name. 

CDCNET Host Application (CHA1) Product Content 

The CDCNET host application procedure consists of the following components and 
utilities: 

• HOST message template file 

• INITMDI (Initialize MDI) 

• NAMSTRT records 

• NETBDF (Build CDCNET Directory File) 

• NETFM (Network File Manager) 

• NETFS (Network File Server) 

• NETITF (Initialize NETOU Template File) 

• NETLS (Network Log Server) 

• NETMDF (Merge CDCNET Directory File) 

• NETOU (Network Operator Utility) 

• NETPLM (Network Procedure Library Manager) 

• NETRDF (Restructure CDCNET Directory File) 

• NLTERM (Network Log File Termination Utility) 

• PIM (MDI Loader PP Program) 
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CDCNET requires NAM and many of its programs and procedures. 

The CDCNET network applications installation procedure modifies the network 
startup master file (NAMSTRT), adds new job startup calls into the network startup 
records (INIT, MULTI, etc.) and adds the corresponding job skeletons. 

Entries for the DIs must be specified in the EQPDECK before a CDCNET network 
can be functional. This information is in the NOS Version 2 Analysis Handbook. 

The CDCNET Operations Handbook and the CDCNET Configuration and Site 
Administration Guide describe the CDCNET Host Applications and Utilities. 

Installing CDCNET rebuilds the NAM network file collector. The collector is modified 
to collect the many dump and trace files that the CDCNET Host Applications and 
Utilities generate. 

Unique Parameters 

Parameter Description 

DEBUG To add code to aid in debugging and maintenance, specify the keyword 

DEBUG on the call to the CHAl installation procedure. NETFS, NETLS, 
NETOU, and NLTERM abort on certain error conditions. 

NOTRACE To disable AIP trace file creation for the CDCNET Host Applications 
and Utilities, specify the keyword NOTRACE on the call to the CHAl 
installation procedure. 

ID This parameter sets the identifying character (A..Z,0..9) for the template 

file, HTF_id_psrout. The default is A. Change this character whenever 
CHAl is rebuilt with a change that affects the template file. This 
parameter allows you to have multiple versions of the host template file. 
This id parameter is also supplied to the GENMSG procedure for 
creating the combined template file. 

USER File Directives 

To disable usage of SORT5 by NETFM, include the directive: 

♦DEFINE N0SRT5 

on a USER file when executing the CHAl installation procedure. By specifying this 
directive, NETFM does not use SORT5 and NETFM list output is displayed in unsorted 
order. Use of this directive is not recommended. 

Installation Parameters 

The following CHAl installation parameters are defined in the common deck INPARU. 
To change these parameters, place the appropriate Update directives in a USER file 
and apply the file to the CHAl installation procedure. 
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Parameter 

Default 

Description 

NFA$NFILES 

50' 

Number of CDCNET file entries the directory is 
expected to contain. This parameter is used by the 
NETBDF utility to build a directory file (NETDIR). 

NFA$PUN 

NETOPS 

Primary user name that is allowed WRITE permission 
on the directory file. 

NFS$ALTUN 

NETADMN 

The user name that is permitted WRITE access to 
files created by the Network File Server. Alternate 
catlist of these files is also available to this user 
name. 

NLS$ALTUN 

NETADMN 

The user name that is permitted READ APPEND 
(RA) access to created log files. Alternate catlist of 
the created log files is available to this user name. 

The following CHA1 installation parameter is defined in the common deck NETCOM. 

To change this parameter, place the appropriate Update directive in a USER file and 
apply the file to the CHA1 installation procedure. 

Parameter 

Default 

Description 

NFA$CATALOG 

NETDIR 

Name of the CDCNET directory file. 

The deck INPARU also contains installation parameters that enable the site to select 
retain timer values pertinent to Network File Server (NETFS) performance. The retain 
timer parameters and their default values are listed below. 

Parameter 

Default Retain 

Timer Value 

(in seconds) CDCNET File Type 

RTBOOT 

5 

BOOT 

RTCONFIGUR 

5 

CONFIGURATION 

RTCONFPLIB 

30 

CONFIGURATION LIBRARY 

RTDUMP 

0 

DUMP 

RTEXCEPTION 

5 

EXCEPTION 

RTLIBRARY 

180 

MODULE LIBRARY 

RTLOAD 

30 

LOAD_PROCEDURE 

RTLOADPLIB 

30 

LOAD_PROCEDURE LIBRARY 

RTTERMINAL 

30 

TERMINAL. DEFINITION_PROCEDURE 

RTTERMPLIB 

30 

TERMINAL.DEFINITION PROCEDURE 
LIBRARY 

RTUNDEF 

0 

All others 

RTUSER 

30 

TERMINAL. USER.PROCEDURE 

RTUSERPLIB 

30 

TERMINAL.USER.PROCEDURE LIBRARY 
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Message Templates 

When CHA1 is built, it creates a message template file, HTF_id_psrout, in addition to 
binaries for the deadstart tape and NAMSTRT records. In the file, id is a single 
character supplied to the CHA1 installation procedure, and psrout is a common 
DECKOPL parameter set in COMMOD. The template file created by CHA1 is combined 
with the template file released by CDCNET, CTF_vvvv where vvvv is the CDCNET 
version level. These files are combined using the GENMSG procedure in file DCNPLIB 
on the network administration user name to create a combined binary template file, 
TF_id_vvvv. GENMSG should be executed whenever CHA1 is rebuilt or a CDCNET 
BCU is installed. Call the GENMSG procedure from the network administration user 
name. 

BEGIN!GENMSG,DCNPLIB,ID= id,V=vv vv,P=psrout [, PURGE ] ) 

Parameter Description 

ID = id 


P = psrout 
PURGE 


V = vvvv 


Once GENMSG is complete, you can activate the new file using the SETVL procedure 
described earlier in this section. Make sure you specify NETOU for the tool parameter 
when executing SETVL. The next invocation of NETOU will use the new template file. 


The id character of the template file created by CHA1. HTF_id_ 
psrout is attached from the installation user name. If the file is 
not found, GENMSG ATTACHes the file from the network 
administration user name. 

The PSR level of CHA1. 

A keyword to tell GENMSG to PURGE the combined template 
file TF_id_vvvv if it exists. Without this parameter, GENMSG 
by default does not overwrite an existing TF_id_vvvv file. 

The CDCNET version level to combine with your host template 
file. CTF_vvvv is ATTACHed from the network administration 
user name. 
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NAM Startup Procedure File Changes 

The CDCNET network is started using the same commands (NAMNOGO, etc.) as the 
CCP network. Refer to the NAM Procedure File subsection in the NAM5 section of this 
chapter. 

CDCNET applications use the same NAMI job startup procedure as does NAM, with 
the following additions to NAMSTRT: 

• Application startup calls in network startup records: 


Call 

Description 

J OB(J OBFS,SF,SY,NS) 

Network File Server 

JOB(JOBOU,UO,SY,NS) 

Network Operator Utility 

JOB(JOBLS,SL,SY,NS) 

Network Log Server 

JOB(JOBINMD,IN,SY,NS) 

INITMDI (MDI Initializer) 

JOB(JOBFSR,FS,DI,SY,NS) 

File Server Restart Job 

J OB(J OBLSR,LS,DI,SY,NS) 

Log Server Restart Job 

JOB(JOBOUR,OU,DI,SY,NS) Operator Utility Restart Job 

• Job skeleton records JOBFS, JOBOU, JOBLS, JOBFSR, JOBLSR, JOBOUR, 
JOBINMD 

• Parameters for the standard NAM startup records: 

Parameters 

Description 

PARAM(CDCNET= YES) 

Informs collector job, JOBCOL, to process dump files. 

PARAM(FSSTART=NO) 

Prevents the Network File Server from starting when 
NAM comes up. 

PARAM(LSSTART = NO) 

Prevents the Network Log Server from starting when 
NAM comes up. 

PARAM(OUSTART=NO) 

Prevents the Network Operator Utility from starting 
when NAM comes up. 

PARAM(ZZFC = 500) 

Flush count for log file buffer (used only by NETLS). 

NOTE 

- 

A YES value on any of the middle three parameters listed causes that application to 
start when NAM comes up. When NO is used, the applications start automatically 
when they are needed. 
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CDCNET Network Host Application Program Requirements 

Job skeleton records for NETFS, NETLS, NETOU, and INITMDI jobs must contain a 
command that calls the program the job intends to run. These commands have the 
following format: 

prog(parameterl.parametern) 

Field Description 

prog Program call. May be NETFS, NETLS, NETOU, or INITMDI. 

parameteri Unless specified otherwise, these are optional, order-independent 

parameters. They may be of the form: 

keyword = value 
or 

keyword 

The files used by each program are listed following the description of each program 
call. 
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NETFS - Network File Server 


NETFS requires the following command: 
NETFS(MC=mc, NIN=nin) 


Parameter 

Description 

MC = mc 

Maximum message count; specifies the maximum number of 
messages to be accumulated in the debug log file before 

NETREL is called. No NETREL call is issued if MC = 0. The 
default value, which is 500, may be reset using the ZZMC 

PARAM statement. 

NIN = nin 

Network invocation number; 1- to 3-digit decimal number 
assigned by NAM when the network operation is started. This 
parameter is required. 

NETFS requires the following files: 

File 

Description 

NETDIR 

The network directory contains entries that match NOS permanent files 
to logical file references used by CDCNET Host Applications and 
Utilities. A default NETDIR is provided with the network. 

NRF1 

The job record to be copied to the ZZZZZDN file by NETREL. This job 
record determines the disposition of the network trace file when 
NETREL is called on a periodic basis. 

NRF2 

The job record to be copied to the ZZZZZDN file by NETREL. This job 
record determines the disposition of the network trace file When 
NETREL is called as a result of an operator command. 

NOTE 


The default job skeleton of NETFS creates NRF1 and NRF2 from the input records of 
the NETFS job. 
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NETLS - Network Log Server 
NETLS requires the following command: 
NETLS(MC=mc,NIN=nin,FC=fc) 


Parameter 

Description 

o 

II 

8* 

Flush count; specifies the number of characters received in log 
data before the log buffer is flushed and an end-of-record is 
written. The default, which is 2750 characters, may be reset 
using the ZZFC PARAM statement. If the value is one, the 
buffer is flushed after each log block. 

MC = mc 

Maximum message count; specifies the maximum number of 
messages to be accumulated in the debug log file before 

NETREL is called. No NETREL call is issued if MC = 0. The 
default value, which is 500, may be reset using the ZZMC 

PARAM statement. 

NIN=nin 

Network invocation number; 1- to 3-digit decimal number 
assigned by NAM when the network operation is started. This 
parameter is required. 

NETLS requires the following files: 

File 

Description 

NRF1 

The job record to be copied to the ZZZZZDN file by NETREL. This job 
record determines the disposition of the network trace file when 
NETREL is called on a periodic basis. 

NRF2 

The job record to be copied to the ZZZZZDN file by NETREL. This job 
record determines the disposition of the network trace file when 
NETREL is called as a result of an operator command. 

NOTE 


The default job skeleton of NETLS creates NRF1 and NRF2 from the input records of 
the NETLS job. 
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NETOU - Network Operator Utility 
NETOU requires the following command: 
NETOU(NIN=nin.MC=mc,DM=dm,PROMPT,TDF=lfn) 


Parameter 
DM = dm 


MC = mc 


NIN = nin 


PROMPT 


TDF=lfn 


Description 

Node number of the MDI to be used as the default. If you select 
a specific MDI, this MDI is used to communicate with CDCNET. 
If the parameter is not specified or the operator software in the 
MDI is not connected to the host, the MDI that has been 
connected the longest is used as the default MDI. 

Maximum message count. Specifies the maximum number of 
messages to be accumulated in the debug log file before NETREL 
is called. No NETREL call is issued if MC = 0. The default value, 
which is 500, may be reset using the ZZMC PARAM statement. If 
NETOU was built with the NOTRACE option, then no messages 
are written. 

Network invocation number. One- to three-digit decimal number 
assigned by NAM when the network operation is started. This 
parameter is required. 

If the parameter is present and there is more than one MDI 
connected to NETOU, all the operators are prompted for selection 
of an MDI when the operator logs in. If this parameter is not 
present, the default MDI is transparently selected for an operator 
at login. 

The local file name of the template definition file. This file 
contains the templates used to format messages for display and 
must have been generated by the utility NETITF. The default 
local file name is TEMPLTB. 
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NETOU requires the following files: 


File Description 

INITDCN Procedure indicating parameter values for id and vvvv for template 
file name. Must be stored on the network administration user name. 
This file is created as part of the CDCNET installation. 


NRF1 The job record to be copied to the ZZZZZDN file by NETREL. This 

job record determines the disposition of the network trace file when 
NETREL is called on a periodic basis. 


NRF2 The job record to be copied to the ZZZZZDN file by NETREL. This 

job record determines the disposition of the network trace file when 
NETREL is called as a result of an operator command. 

TF_id_vvvv The default file name of the template definition file. This file contains 
the templates used to format messages for display and must have 
been generated by the utility NETITF. The file name being used is 
controlled by using the INITDCN procedure on the network 
administration user name. 


NOTE 


The default job skeleton of NETOU creates NRF1 and NRF2 from the input records 
of the NETOU job. 


INITMDI - Initialize MDI 

INITMDI requires the following command: 

INITMDI(B=1fn1,D=xx,L=lfn2,NAM=nam,EST=est,DT=dt,NIN=nin,V=ver) 

Parameter Description 

B = lfnl Load library local file name. If B = lfnl is not present or B = 0, 

the load file is accessed using the reference in NETDIR, of the 
form BOOT#ver MCI (ver is described under the V = ver 
parameter that follows). 

D = xx Dump file name prefix. If D = xx is not specified, the default 

prefix is DI. If D=0, no dump file is created. If specified, the 
first character should be alphabetic and the second should be 
alphanumeric. A permanent dump file is created on the system 
with a name of the form xxyyNIN (xx is the prefix, yy is two 
alphanumeric characters that increment (AA..A9,BA..B9,etc.) for 
each dump taken within the same network invocation number 
(NIN). A reference to this dump file is created in NETDIR of 
the form DUMP#FULL_systemid_yymmddhhmmss (where 
systemid is the unique identifier for each DI and 
yymmddhhmmss is the year, month, day, hour, minute, and 
second when the dump was taken). 

DT=dt Device type (EST name). This parameter is required and 

consists of two alphanumeric characters. Refer to the NOS 
Version 2 Analysis Handbook for more information. For an 
MDI, this parameter is DT = ND. 
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Parameter Description 

EST = est EST ordinal of the MDI. This parameter should not be specified 

if automatic loading by NAM is used (NAM searches the EST 
table for MDIs requesting a load). If specified and if no suffix or 
the suffix B is used, the base is octal. Octal range is 1 to 777. If 
the suffix D is specified, the value is decimal with a range 1 to 
511. 


L=lfn2 Message history file. If L=lfn2 is not specified or L=0 is 

specified, no message file is produced. Messages concerning load, 
dump, and errors are written to this file. L = OUTPUT should be 
used. 


NAM = nam If this parameter is not specified or NAM = NO is specified, the 

NAM interface is assumed to not be present. If NAM or 
NAM = YES is specified, the NAM operator interface is used for 
error messages. 

NIN = nin Network invocation number: 1- to 3-digit decimal number that is 

placed in the NIN field of messages written into the L file. If not 
specified, the default is 000. 


V —ver Version number of the load file. This consists of hexadecimal 

digits. 

The actual call to INITMDI is contained in the procedure INITDCN on the network 
administration user name. Any parameter changes to INITMDI should be made in that 
file. The released INITMDI call is of the form: 


INITMDI(L“OUTPUT,DT=ND,NIN=CIN,V=vvvv). 


INITMDI requires the following files: 

File Description 

NETDIR The network directory contains entries that match NOS permanent 

files to logical file references used by CDCNET Host Applications and 
Utilities. A default NETDIR is provided with the network. 

INITDCN This procedure contains the actual INITMDI call. The primary 

function of INITDCN is to set the version level (V=ver) parameter. 
This file is created as part of the CDCNET installation. 
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NETOU requires the following files: 


File Description 

INITDCN Procedure indicating parameter values for id and vvvv for template 
file name. Must be stored on the network administration user name. 
This file is created as part of the CDCNET installation. 


NRF1 The job record to be copied to the ZZZZZDN file by NETREL. This 

job record determines the disposition of the network trace file when 
NETREL is called on a periodic basis. 

NRF2 The job record to be copied to the ZZZZZDN file by NETREL. This 

job record determines the disposition of the network trace file when 
NETREL is called as a result of an operator command. 

TF_id_vvvv The default file name of the template definition file. This file contains 
the templates used to format messages for display and must have 
been generated by the utility NETITF. The file name being used is 
controlled by using the INITDCN procedure on the network 
administration user name. 


NOTE 


The default job skeleton of NETOU creates NRF1 and NRF2 from the input records 
of the NETOU job. 


INITMDI - Initialize MDI 

INITMDI requires the following command: 

INITMDI(B=1fn1,D=xx,L=1fn2,NAM=nam,EST=est,DT=dt,NIN=nin,V=ver) 

Parameter Description 

B = lfnl Load library local file name. If B = lfnl is not present or B = 0, 

the load file is accessed using the reference in NETDIR, of the 
form BOOT#ver MCI (ver is described under the V = ver 
parameter that follows). 

D = xx Dump file name prefix. If D = xx is not specified, the default 

prefix is DI. If D = 0, no dump file is created. If specified, the 
first character should be alphabetic and the second should be 
alphanumeric. A permanent dump file is created on the system 
with a name of the form xxyyNIN (xx is the prefix, yy is two 
alphanumeric characters that increment (AA..A9,BA..B9,etc.) for 
each dump taken within the same network invocation number 
(NIN). A reference to this dump file is created in NETDIR of 
the form DUMP#FULL_systemid_yymmddhhmmss (where 
systemid is the unique identifier for each DI and 
yymmddhhmmss is the year, month, day, hour, minute, and 
second when the dump was taken). 

DT = dt Device type (EST name). This parameter is required and 

consists of two alphanumeric characters. Refer to the NOS 
Version 2 Analysis Handbook for more information. For an 
MDI, this parameter is DT = ND. 
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Parameter Description 

EST ordinal of the MDI, This parameter should not be specified 
if automatic loading by NAM is used (NAM searches the EST 
table for MDIs requesting a load). If specified and if no suffix or 
the suffix B is used, the base is octal. Octal range is 1 to 777. If 
the suffix D is specified, the value is decimal with a range 1 to 
511. 

Message history file. If L=lfn2 is not specified or L = 0 is 
specified, no message file is produced. Messages concerning load, 
dump, and errors are written to this file. L=OUTPUT should be 
used. 

If this parameter is not specified or NAM = NO is specified, the 
NAM interface is assumed to not be present. If NAM or 
NAM = YES is specified, the NAM operator interface is used for 
error messages. 

Network invocation number: 1- to 3-digit decimal number that is 
placed in the NIN field of messages written into the L file. If not 
specified, the default is 000. 

Version number of the load file. This consists of hexadecimal 
digits. 

The actual call to INITMDI is contained in the procedure INITDCN on the network 
| administration user name. Any parameter changes to INITMDI should be made in that 
file. The released INITMDI call is of the form: 

INITMDI(L=OUTPUT.DT=ND,NIN=CIN,V=vvvv). 

INITMDI requires the following files: 

File Description 

NETDIR The network directory contains entries that match NOS permanent 

files to logical file references used by CDCNET Host Applications and 
Utilities. A default NETDIR is provided with the network. 

INITDCN This procedure contains the actual INITMDI call. The primary 

function of INITDCN is to set the version level (V=ver) parameter. 

This file is created as part of the CDCNET installation. 


EST = est 


L=lfn2 


NAM = nam 


NIN = nin 


V = ver 
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Network Definition Language (NDL) Requirements 

To run CDCNET, you must modify the Local Configuration section of the existing 
Network Definition File to include application definition (APPL) statements and 
INCALL statements. The released NDL file NDLDATA, on the network administration 
user name, contains an example of the required statements. They are as follows: 


LCFFILE 


LFILE. 

NETOU 


APPL KDSP,RS,PRIV. 

NETFS 


APPL KDSP,RS.PRIV. 

NETLS 


APPL RS,PRIV. 

NLTERM 


APPL KDSP.PRIV. 

INCALL 

FAM=0,UNAME =NETOPS,ANAME =NETOU, 
DBL=7,ABL=7,DBZ=2043,UBZ=20,UBL=7 

INCALL 

FAM=0,UNAME=NETOPS,ANAME =NETLS, 
DBL=7.ABL=7,DBZ=2043,UBZ=20,UBL=7 

INCALL 

FAM=0,UNAME =NETOPS,ANAME =NETFS, 
DBL=7,ABL=7,DBZ=2043,UBZ=20,UBL=7 

INCALL 

FAM=0,UNAME=NETOP$,ANAME =NLTERM, 
DBL=7,ABL=7,DBZ=2043,UBZ=20,UBL=7 

END. 




NOTE 


The user name NETOPS, in the previous text, refers to the Control Data default 
value for the network operations user name. If you have changed this value, 
substitute your site name for the Control Data default value. 


For complete information on the meaning of the statements, refer to the Network 
Definition Language Reference Manual. 


Revision L 


Special Product Installation Information 7-77 



CDCS2 - CYBER Database Control System Version 2 


CDCS2 - CYBER Database Control System Version 2 

This section describes these installation options for CDCS2: 

• Unique Parameters 

• CDC Procedure File 

• Special Notes 

• Accounting Table 

Unique Parameters 

Parameter Description 

DEBUG To activate commands that generate CDCS flow points, specify the 

keyword DEBUG on the call to CDCS2. These flow points trace the 
execution of CDCS modules from initialization to termination. 

Generation of the flow points increases the execution size of CDCS by 
approximately 25008 words. 

For more information on activating the interface between CDCS2 and COBOL5, refer to 

the COBOL5 section in this chapter. 

CDC Procedure File 

Refer to Subsystem Initiation, at the beginning of this chapter, for information about 

the CDC startup procedure file and subsystem initiation. Refer to the CYBER Database 

Control System 2 Reference Manual for instructions on constructing the procedure file. 


Special Notes 

• CDCS2 users must have permission to use the system control point facility and 
the system control point facility must be enabled. Refer to the NOS Version 2 
Administration Handbook for a description of MODVAL and the NOS Version 2 
Analysis Handbook for information on the SCP IPRDECK entry. 

• To activate a debug trace facility for CDCS2, specify the E parameter on the 
SYMPL commands in the CDCS2 installation procedure. 


Accounting Table 

The CDCS routine DB$ACCT contains a table of average central processor (CP) and 
input/output (I/O) times, in microseconds, for CDCS user requests. These average values 
were obtained from simulation runs on a model 74 and adjusted based on actual runs 
performing file creation and updating on indexed sequential files with a record size of 
40 words. 

When a user issues a CDCS request, such as open, read, or rewrite, CDCS retrieves 
the value from the appropriate table entry and accumulates it in the accounting 
accumulator for the individual user. CDCS accumulates the charged CP and I/O time 
for all users combined and prints it in the dayfile at the end of the CDCS session. 

The actual time used for the entire CDCS session is also printed in the dayfile. 
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Because different environments produce different values for the average CP and I/O 
times required for each user request, CDCS provides options for the database 
administrator to modify these table values. 


One method of modification is specifying new values for the CP and I/O times on the 
command that initializes CDCS (refer to the CDCS 2 Data Administration Reference 
Manual). With this method, all the entries in the accounting table are multiplied by 
the ratio of the specified value to the table value for a random read on an indexed 
sequential file. 

A second method of modification is changing the values in the accounting table and 
installing CDCS with the recompiled table. You can modify any or all entries in the 
table. List the deck DB$ACCT to see the current values in the accounting table. 
Entries in the table are in COMPASS macro format, as follows. 

Field 1 (column 1) Blank or comma. 

Field 2 (column 2) One of the following user request codes. 

DFASK Ask restart identifier 

DFBEG Begin transaction 

DFCLS Close 

DFCMT Commit transaction 

DFDBS Database status block 

DFDEL Delete 

DFDRP Drop transaction 

DFEND End 

DFGID Get restart identifier 

DFINV Invoke 

DFLOG Logging 

DFLOK Lock 

DFOPN Open 

DFPVC Privacy 

DFRD1 Sequential read 

DFRD2 Random read 

DFREW Rewrite 

DFRPT Recover point 

DFRSR Relation start 

DFRWF Rewind area file 

DFRWR Rewind relation 

DFRWX Rewind index file 

DFRX1 Read sequential on index file 

DFRX2 Read random on index file 

DFSKF Skip 

DFSTR Start 

DFSTX Start on index file 

DFTER Abnormal termination 

DFULK Unlock 

DFVER Version change 

DFWR2 Random write 

Field 3 (column 11) The macro identifier ACC. 
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Field 4 (column 18) CP and I/O times required by each request. Parameters 

represent the different types of charges according to different 
file organizations, logging, and other factors. Possible 
parameters are as follows. 


AK 

AK primary key charge 

ALT 

Alternate key charge 

ARL 

Area logging flag 

DA 

DA primary key charge 

FIX 

Fix charges 

IS 

IS primary key charge 

ISJLG 

Journal logging charge 

JNL 

Journal logging flag 

MOD 

Database modification flag 

QLG 

Quick recovery logging charge 

QRF 

Quick recovery logging flag 


The following is an example of an entry in the table. 

DFRD2 ACC ((IS=4000,7000),(DA=3500,6500),(AK=3000,6000),(ALT=3000,7000)) 

This entry states that for a random read performed on (for example) an indexed 
sequential file, the CP charge is 4000 microseconds, and the I/O charge is 7000 
microseconds. 
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CID - CYBER Interactive Debug Version 1 

The following installation parameters define the size of various tables used by CID. 
Certain table sizes are defined by parameters in both SYMPL and COMPASS decks. If 
you alter such a table size, change all installation parameters defining the table size. 
Compile or assemble the indicated Update decks to obtain sequence information. 


Parameter 

Default 

Description 

BREAKTABSIZE 

16 

Number of entries in breakpoint table. Parameters 

TABSIZE 

16 

are located in common decks BREAKD (SYMPL) and 
BREAKZ (COMPASS). 

GROUPTABSIZE 

16 

Number of entries in group table. Parameters are 

TABSIZE 

16 

located in common decks GROUPD (SYMPL) and 
GROUPZ (COMPASS). 

TRAPTABSIZE 

16 

Number of entries in trap table. TRAPXSIZE and 

TRAPXSIZE 

19 

XSIZE must each be three greater than the 

TABSIZE 

16 

tablesize defined by TRAPTABSIZE and TABSIZE. 

XSIZE 

19 

Parameters are located in common decks TRAPD 
(SYMPL) and TRAPZ (COMPASS). 

ROOM54 

10B 

Number of words available for EACPM loader table (54 
table) expansion before CID must recreate its overlays 
at debug time. Parameter is located in deck DBUGI. 
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CML - Concurrent Maintenance Library 

There is no installation procedure for CML in the DECKOPL procedure file. Refer to 
the Concurrent Maintenance Library Reference manual for installation information. 
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COBOL5 and COBOL5Q - COBOL Version 5 

This section describes the following installation options for COBOL5: 

• Installation Procedures 

• Unique Parameters 

• Installation Parameters 

Installation Procedures 

COBOL Version 5 has two methods of customized installation: the full mode 
installation, which assembles and compiles all compiler and object library routines, and 
the Q (or quick) mode installation (deck COBOL5Q). 

The Q mode installation procedure option allows you to build a COBOL5 compiler 
that has been modified. It compiles or assembles only those routines which have been 
modified and combines the binaries produced with a previous release level of 
COBOL5 to create a new compiler by use of the COPYL utility. You must provide 
^COMPILE directives on a USER file for any affected routine. 

The purpose of using the Q mode procedure is to allow you to modify the COBOL5 
compiler without compiling and assembling the entire compiler. This mode should be 
used only to modify the compiler with corrective code or user code which does not 
affect common decks. For example, you may want to use the Q mode installation 
option to activate Data Management, set default page size, or enable COBOL5 to use 
CMU. 

Unique Parameters 

The COBOL 5 compiler is released supporting the TAF and CDCS interfaces. The 
compiler will function correctly if you do not install either TAF or CDCS. By default, 
the compiler will be built supporting the interfaces. To disable either or both 
interfaces, use the keyword parameters below. 


Parameter Description 

NOCDCS To deactivate the interface between COBOL5 and CDCS2, specify the 
keyword NOCDCS on the call that executes the installation procedure 
for COBOL5 or COBOL5Q. Relocatable binaries created by compiling 
COBOL5 programs on a system that has the COBOL5 CDCS interface 
do not execute on a system that does not have this interface. The 
reverse is also true: relocatable binaries created by compiling on a 
system that does not have the COBOL5 CDCS interface fail to execute 
on a system that does have the CDCS interface. 

NOTAF To deactivate the interface between COBOL5 and TAF, specify the 

keyword NOTAF on the call that executes the installation procedure 
for COBOL5 or COBOL5Q. 
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Installation Parameters 

The COBOL5 compiler uses IPTEXT symbol definitions, which are filtered through 
CB5TEXT. No direct references to any IPTEXT symbols are contained in the compiler 
or the object routines. This allows you more flexibility in changing normal installation 
parameters for COBOL5. 

The system obtains symbols governing machine type, character set, and CMU option 
from IPTEXT. To override one or more system defaults, select the desired changes 
from the following list and put them on a USER file for the COBOL5 or COBOL5Q 
installation procedure. 

• To change the default error termination level to T, W, F, or C, use 1, 2, 3, or 4, 
respectively, for level in the following statement. The DEF CB5$ET statement is 
in deck ASSEMOP. 

DEF CB5$ET#level#; 

• To change the default organization (xx) for actual key, direct access, or indexed 
files from version 2 (ORG=NEW) to version 1 (ORG = OLD), locate 
CB5$xxOLDNEW in deck ASSEMOP and change it to: 

DEF CB5$XxOLDNEW ft OLD 


XX 

Description 

AK 

Actual key files. 

DA 

Direct access files. 

IS 

Indexed files. 
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DCL - Data Catalogue 2 Version 2.0 

This section describes the following: 

• Product Dependencies 

• SYSGEN Functions 

Product Dependencies 

The COBOL5 compiler and library must be available to install DCL. The product must 
run from permanent files. 

SYSGEN Functions 

SYSGEN installs all files for DCL on user name LIBRARY. If you customize the DCL 
files, install the modified files by following these steps: 

1. Before running the DCL installation procedure, execute these commands on your 
installation user name: 

PURGE(PFGDCL2/NA) 

DEFINE!PFGDCL2/CT=S) 

RETURN!PFGDCL2) 

2. Run the DCL installation procedure. When the procedure is finished executing, 
enter these commands at the system console: 

X.DIS. 

USER(SYSTEMX,SYSTEMX) 

ATTACH!PFGDCL2/UN=1nsun) 

SYSGEN!DCL2) 
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DUAL - Dual State 

This section describes the following: 

• Unique Parameters 

• Configuration Information 

• Dual State Source Library 

• Dual State Upgrade of NOS Only 

• Dual State on Older NOS Systems 

• NOS and NOS/VE Memory Allocation 

• NOS/VE Initiation 

• VEIAF Family Name Selection 

• NOS SETVE Modification 

• NOS RUNJOBS Modification 

• NOS ACCFILE 

• NOS ACCFILE Modification 

Unique Parameters 


Parameter 

Description 

TRACE 

To enable AIP tracing, specify the keyword TRACE on the DUAL 
installation procedure. 

NOSLEV 

Can be three numeric characters. Denotes the level of NOS used to 
build dual state. In the released binaries, this was set to psrout. 

VELEV 

Can be five alphanumeric characters. Denotes the level of NOS/VE used 
to build dual state. In the released binaries, this was set to psrout. In a 
Batch Critical Update, it was set to the correction level. 

CSET 

Denotes the character set of the system. Valid options are 64 or 63. The 
default character set is 64. 
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Configuration Information 

To configure a dual state system, create the following: 

• NVE user name. Create user name NVE for running the NVE subsystem. (The 
user name is created automatically with the password of NVEX in a first-time 
installation.) If you create the user name yourself, the user name should have 
these additional validations added to the default NOS validations: 

AP=IAF, AP=VEIAF, AW=CASF, AW=CAND, AW=CCNR, AW=CLPF, AW=CSPF, 

AW=CUCP, AW=CNVE, AW=CTIM, AW=CUST, AW=CQLK, CC=77B, CM=30B, 

CS=7, DB=2, DF=77B, FS=6, LP=77B, MS=76B, MT=1, SAV=CULT, 

SL=77B, TL=77B, VM=CT 

• LIDCMid file. This file defines the physical and logical machines available to your 
system. (The id in LIDCMid is the two alphanumeric characters from the MID 
CMRDECK entry that make up your machine identifier. The released default id is 
AA.) The number of entries in the LIDCMid file determine the value specified in 
the LDT CMRDECK entry. The LIDCMid file is stored as an indirect access 
permanent file on user name SYSTEMX (user index 377777B). In addition to 
entries in this file for dual state, entries are also made for PTF/QTF, the Remote 
Host Facility (RHF), and the NOS Scope Station Facility. A sample LIDCMid file 
is provided with the release materials. This file should be edited on the 
installation user name, then moved to user name SYSTEMX. 

For a first-time installation, GET the sample file from user name SYSTEMX 
directly. If you are installing dual state for the first time during a NOS upgrade, 
execute the SYSGEN(DUAL.LID) procedure from the installation user name to 
load a copy of LIDCMid (and LIDVEid) to the installation user name. 

To move the LIDCMid file to user name SYSTEMX, execute the command 
SYSGEN(MOVE,LIDCMid,SYSTEMX„Y,PERMIT) from the system console when 
directed to by instructions in chapters 2, 3, or 4. (The PERMIT parameter allows 
read access to the file from the installation user name.) Once the file has been 
moved, build the LID table in central memory using the CLDT system program. 

To use CLDT, ensure that NAM, IAF, RHF, and SSF are not running and enter 
the command X.CLDT. from the system console. (CLDT is executed automatically 
at NOS deadstart if an LDT entry exists in the CMRDECK.) 

• LIDVEid file. This file defines the Logical Identifiers (LIDs) used by NOS/VE 
batch jobs. (The id in LIDVEid is the two alphanumeric characters from the 

MID CMRDECK entry that make up your machine identifier. The released default 
id is AA.) LIDVEid is an indirect access permanent file stored on user name 
SYSTEMX (user index 377777B). A sample LIDVEid file is provided with the 
release materials. This file should be edited on the installation user name, then 
moved to user name SYSTEMX. 

For a first-time installation, GET the sample file from user name SYSTEMX 
directly. If you are installing dual state for the first time during a NOS upgrade, 
execute the SYSGEN(DUAL,LID) procedure from the installation user name to 
load a copy of LIDVEid (and LIDCMid) to the installation user name. 

To move the LIDVEid file to user name SYSTEMX, execute the command 
X.SYSGEN(MOVE,LIDVEid,SYSTEMX„Y,PERMIT) from the system console. 
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• LDT CMRDECK entry. This entry defines the size of the Logical Identifier Table 
in central memory. The size of the table is determined by the number of entries 
in the LIDCMid file. 

• VE CMRDECK entry. This entry in combination with or instead of the MINCM 
CMRDECK entry defines NOS/VE and the amount of memory to reserve for 
NOS/VE. Refer to NOS and NOS/VE Memory Allocation later in this section. 

• MINCM CMRDECK entry. This entry defines the amount of memory to reserve 
for NOS. Refer to NOS and NOS/VE Memory Allocation later in this secton. 

• EQPDECK entries for sharing memory. The VEMEM utility, documented under 
NOS and NOS/VE Memory Allocation later in this section, helps determine the 
entries needed to allocate memory between NOS and NOS/VE. 

• EQPDECK entries for sharing peripherals. This topic is discussed in the Deadstart 
Decks section of the NOS Version 2 Analysis Handbook. 

• IPRDECK entries for controlling initiation of NOS/VE. See NOS/VE Initiation 
later in this section. 

For more information about the LIDCMid and LIDVEid files and the LDT CMRDECK 
entry, refer to the LID/RHF Configuration Files section of the NOS Version 2 Analysis 
Handbook. For additional information about the CMRDECK and EQPDECK entries, 
refer to the Deadstart Decks section of that handbook. 

Dual State Source Library 

The Dual State Source Library is in multifile PFGDUAL (for BCUs, it is in multifile 
PFGBCU2). To access it, execute the following command from your installation user 
name: 

SYSGEN(DUAL,SOURCE) 

For BCUs, execute: 

SYSGEN(DUAL,SOURCE,BCU) 

This creates (or replaces) the file named VEDSSL, which contains the Dual State 
Source Library in NOS/VE format. 

To rebuild the dual state components or to modify the software, you must transfer 
file VEDSSL to NOS/VE. To modify the file on NOS/VE, you must use the NOS/VE 
Source Code Utility. Once all desired modifications (if any) are complete, the source 
library is converted to a text file that is transferred back to NOS. The text file is 
used as input to the NOS DECKOPL installation procedure DUAL for compiling the 
dual state components. The dual state source library should be kept on a NOS/VE 
user name from which other NOS/VE maintenance activities can be performed. 
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This user name should give read execute permission to the file 

$SYSTEM.SOFTWARE.MAINTENANCE.RAF$LIBRARY 

This can be done from the NOS/VE console with the command: 

CREATE_FILE_PERMIT $SYSTEM.SOFTWARE_MAINTENANCE.RAF$LIBRARY .. 

G=USER FN=f ami ly name U=username 

where familyname and username are for the analyst who maintains the Dual State 
Source Library. 

1. To transfer the library to NOS/VE, log in to NOS/VE and execute these 
commands: 

SET_LINK_ATTRIBUTES U=(Insun,nosfamily) PW=batchpassword 
GET_FILE $USER.DUAL_STATE_SOURCE_LIBRARY VEDSSL DC=B56 

2. To transfer the modified source library to NOS, use these commands: 

CREATE_COMMAND_LIST_ENTRY E=$SYSTEM.SOFTWARE_MAINTENANCE.RAF$LIBRARY 
CONVERT_DSSL_TO_TEXT SUSER.DUAL_STATE_SOURCE_LIBRARY DUALpsrin 
SET_LINK_ATTRIBUTES U=(insun,nosfamily) PW=batchpassword 
REPLACE_FILE DUALpsrin 

Replace psrin with the PSR level of NOS. Note that the command: 

CONVERT_DSSL_TO_TEXT SUSER.DUAL_STATE_SOURCE_LIBRARY DUALpsrin 

produces the following two warning messages: 

-- WARNING SC105 — Deck DSA$FAKE_OS_INTERFACE is not expandable 

-- WARNING SC105 — Deck DSA$FAKE_CM_INTERFACE is not expandable 

This creates a file named DUALpsrin on the NOS installation user name. When 
the DUAL installation procedure is executed, it picks up this file and uses it as 
input. 

NOTE 


The dual state installation procedure (DUAL) must always match the level of the 
Dual State Source Library being assembled. For example, to assemble NOS/VE L664 
with a NOS L647 system, you must use the L664 DECKOPL installation procedure 
for dual state. 


Dual State Upgrade of NOS Only 

Certain back levels of NOS/VE are supported on the released level of NOS. These are 
determined by the support window maintained by Control Data (refer to the NOS/VE 
Software Release Bulletin). To create the binaries that support these systems, you must 
assemble the dual state product. To assemble dual state for these combinations, you 
use the following: 

• The dual state source and corresponding DECKOPL installation procedures from 
the desired level of NOS/VE 
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| • GLOBLIB, PRODUCT, and other needed source from the desired level of NOS 

| After setting the installation procedures to specify the desired NOS level and SEEDing 
with the NOS release deadstart tape, dual state can be reassembled. This is 
accomplished by following the example below. Similar steps are performed for other 
I combinations. 

| NOTE 


| If other products need to be customized during this upgrade to the new NOS level, 

| you should assemble them first by following the instructions in chapter 6. This 
| ensures that the correct output PLs are available when customizing dual state. After 
| completing the steps in chapter 6, return here to assemble dual state. 


| You are running a NOS L678-NOS/VE L678 production system. You have received 
| L688 materials, but wish to upgrade NOS only. As usual, you start executing the 
| instructions in chapter 3, Upgrade Installation. During Step 2, you will be instructed to 
| refer to this section. 

| The following are the files and their PSR levels that are required to assemble 
| binaries to support a NOS L688-NOS/VE L678 system. 

x 

| L688 _ L678 _ 

| OPLpsrout DUAL678 

DECKOPL 
INSTALL 
COMMOD 

1. Perform Step 1 of chapter 6. This procedure loads the L688 RECLAIM database 
and various other files that are needed. 

2. Get the L678 release NOS deadstart and permanent file tapes. If you have applied 
a L678 BCU to dual state, you will also need that tape. 

3. Log in to the installation user name and use RECLAIM to obtain the L678 
installation procedures and Dual State Source Library. 

RECLAIM,DB=0,Z./COPY,TN=vsn,D=dens it y ,FN=PFGDECK 

Replace vsn with the VSN of the L678 CDC-supplied permanent file tape. The 
VSN is in the media number field of the external tape label. Replace density with 
the density of the permanent file tape (HY, HD, PE, or GE). 

If you have applied a BCU to dual state, use RECLAIM to obtain file PFGBCU2 
from the BCU tape. If no BCU has been applied, repeat the previous RECLAIM 
command and substitute file PFGDUAL for PFGDECK. 

4. Change the names of files DECKOPL, COMMOD, INSTALL, VEDSSL, and 
DUAL688, if they exist, to something else. Use the local files that were 
RECLAIMed in the previous step to create the installation procedure files and the 
Dual State Source Library. 


| TDU1688 

* 

1 BAMlpsrout 
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DEFINE,DECKOPL,INSTALL,VEDSSL. 

COPYBF,PFGDECK,DECKOPL. 

COPYBF,PFGDECK t INSTALL. 

COPYBF,PFGDECK,COMMOD. 

SAVE,COMMOD. 

• If no BCU has been applied to NOS/VE, enter the following command: 

COPYBF,PFGDUAL,VEDSSL. 

• If a BCU has been applied to NOS/VE, enter the following command: 

COPYBF,PFGBCU2,VEDSSL. 

5. Return all the files and convert the Dual State Source Library to an input 
program library for the DUAL installation procedure. 

RETURN,PFGDECK,PFGDUAL,PFGBCU2,VEDSSL,DECKOPL,COMMOD,INSTALL. 

To convert the Dual State Source Library, follow the instructions in the Dual 
State Source Library section, earlier in this section. However, since file VEDSSL 
was created in step 4, skip the SYSGEN(DUAL,SOURCE) or SYSGEN(DUAL, 
SOURCE,BCU) command. When this step is complete, a file named DUAL688 will 
have been created. 

6. Perform Step 2 of chapter 6, using the L678 DECKOPL materials just loaded. Be 
sure to modify COMMOD so that psrin is 688 and psrout matches the level of 
your output PLs. 

Since older copies of the installation procedures are being used, it is not 
recommended to reassemble any product other than dual state. 

7. Perform Step 3 of chapter 6, if necessary. 

8. Perform Step 4 of chapter 6. Be sure to use the L688 deadstart tape for file 
SYSTEM when executing the SEED procedure. 

9. Step 5 may be skipped, since the composite OPL would have been rebuilt as part 
of the customizing performed earlier. 

10. Execute the DUAL installation procedure. (Refer to Step 6 of chapter 6.) 

11. Perform Step 7 of chapter 6 to create a new deadstart tape. 

12. If you need to customize more products at a later time, files DECKOPL, 

INSTALL, and COMMOD need to be changed back to their L688 NOS versions. 
Refer to the files whose names were changed in step 4 of this section. 

You now have a deadstart tape containing L688 NOS-L678 NOS/VE. You would return 
to Step 3 of chapter 3, as per previous instructions in Step 2 of that chapter. 
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Dual State on Older NOS Systems 

The released level of NOS/VE is supported on certain backlevels of NOS. These are 
determined by the support window maintained by Control Data (refer to the NOS/VE 
Software Release Bulletin). The binaries are contained in RECLAIM dump format on 
file PFGDUAL. They are loaded to disk by executing the following command from an 
interactive terminal logged in to the installation user name. Remember that the 
RECLAIM database must be updated and the SYSGEN procedures must be current 
(refer to Step 2 in chapter 3). 

SYSGEN(DUAL,OLDNOS) 

This creates files with the naming convention NVEoldlev, where oldlev is the PSR 
level of NOS that was used. For example, NVE647 would be a file containing binaries 
to run the released level of NOS/VE on a NOS level 647 system. 

To apply these binaries to your production system and create a new deadstart tape, 
use the following commands: 

COMMON,SYSTEM. 

ATTACH(NVEoldlev) 

SYSGEN(DST,SYSTEM,NVEo1 d 1ev,NEW,0, densit y ) 

Replace oldlev with the NOS level you are running and replace density with the tape 
density of the new deadstart tape. 

NOS and NOS/VE Memory Allocation 

When a mainframe is executing dual state, part of the memory is used by NOS/VE 
and part is used by NOS. Entries in the CMRDECK and EQPDECK determine how the 
physical memory is shared. A set of NOS procedures named VEMEM have been 
provided to help determine the deadstart deck entries needed. If file VEMEM does not 
exist on the installation user name, run SYSGEN(DUAL.LID) from the installation user 
name. This also creates files LIDVEid and LIDCMid. 

To execute VEMEM, enter the following command from an interactive terminal 
logged in to the installation user name: 

LINE. 

BEGIN,VEMEM,VEMEM. 

VEMEM asks you a series of questions about the physical memory of the mainframe, 
as well as how you want to divide the memory between NOS and NOS/VE. The utility 
also helps you allocate your NOS memory for user accessible extended memory (UEC), 
unified extended memory (UEM), and 895 input/output buffers (IOB). 

VEMEM contains extensive help entries and validates all of your input. To obtain 
help during a prompt, enter a question mark (?) followed by a CR. 

When VEMEM has completed, it displays your required CMRDECK and EQPDECK 
entries. The entries are also stored on local file CMREQP. 

A more technical discussion of shared memory is given in the NOS Version 2 
Analysis Handbook. 
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NOS/VE Initiation 

In order to initiate deadstart of NOS/VE, the disk and tape channels and equipment 
used by NOS/VE must be made unavailable to NOS using the DOWN commands and 
the NVE subsystem must be initiated. These steps may occur automatically after NOS 
deadstart completes or manually by using operator commands. 

Specific details are: 

• To automatically down the channels used by NOS/VE, include IPRDECK DSD 
entries which will DOWN the appropriate channels. The commands will be 
executed once NOS deadstart completes and before subsystems are initiated. 

• To automatically initiate the NVE subsystem, include an IPRDECK ENABLE 
entry for the NVE subsystem. Typically, control point 3 is specified on the 
ENABLE entry. In addition, the name of the NVE subsystem startup procedure 
must be NVE. This is set when executing SETVE, as documented in the NOS/VE 
Software Release Bulletin. 

• To select the control point for NVE but not have it initiated automatically, use an 
IPRDECK DISABLE entry. This ensures that the NVE subsystem always runs at 
the same control point. 

Refer to the NOS Version 2 Analysis Handbook for more information on the DSD, 
ENABLE, and DISABLE IPRDECK entries. 

VEIAF Family Name Selection 

Interactive users who access NOS/VE through NAM are normally assigned to the 
default NOS/VE login family. Sites with multiple NOS/VE families can modify the 
MAP_NOS_FAMILY_TO_NOSVE procedure to assign a user to a different NOS/VE 
family. The validated NOS user and family name is passed to the procedure, which 
then returns the user’s assigned NOS/VE family and user name to which the user is 
assigned. This procedure is located in deck IIM$NAM_PASSON on the Dual State 
Source Library. 

NOTE _ 

If this procedure is modified, users will be required to specify the correct NOS family 
and user names on the SET_LINK_ATTRIBUTES command, since the returned 
NOS/VE family and user names will be used for that user’s link attributes. Link 
attributes are used for these NOS/VE commands: CREATE_INTERSTATE_ 
CONNECTION, GET_FILE, REPLACE_FILE, and PRINT_FILE with the DUAL_ 
STATE_ROUTING_PARAMETER (DSRP). 
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NOS SETVE Modification 

If you change the default password of the NOS user name SYSTEMX, then you must 
alter the USER statement in the SETVE procedure. 

To update the SETVE procedure with the correct USER statement, follow these 
general steps: 

1. Modify the Dual State Source Library file on NOS/VE. 

2. Convert the library to text. 

3. Move the converted library to NOS and rebuild dual state. 

4. Create a new deadstart tape. 

As an alternative to the above method, you can use the following general steps to 
temporarily change SETVE: 

1. Modify the SETVE procedure on the system. 

RETURN,SYSTEM,SETVE. 

COMMON,SYSTEM. 

GTR,SYSTEM,SETVE.PROC/SETVE 

Edit file SETVE to update the USER statement. 

2. Put the updated SETVE procedure on a new deadstart tape. 

SYSTEM,DST,SYSTEM,SETVE.NEW,0,dens i t y. 

Replace density with the density of the new deadstart tape (HY, HD, PE, or GE). 
A tape request is issued for an unlabeled tape with VSN = NDT. The tape may be 
assigned from the system console using the following command: 

VSN,est,NDT. 

Replace est with the EST ordinal number of the tape unit where the new 
deadstart tape is mounted. LIBEDIT output is written to a local file named 
SYSLIST. 

Use the new deadstart tape the next time you deadstart and SETVE will run 
correctly. 
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NOS RUNJOBS Modification 

If you change the default password of the NOS user name SYSTEMX, then you must 
alter the USER statements in the RUNJOBS procedure. 

To update the RUNJOBS procedure with the correct USER statement, follow these 
general steps: 

1. Modify the Dual State Source Library file on NOS/VE. 

2. Convert the library to text. 

3. Move the converted library to NOS and rebuild dual state. 

4. Create a new deadstart tape. 

As an alternative to the above method, you can use the following general steps to 
temporarily change RUNJOBS: 

1. Modify the RUNJOBS procedure in the ULIB NVELIB. 

RETURN,SYSTEM,OLD,LGO,DSTLIB. 

COMMON,SYSTEM. 

GTR,SYSTEM,OLD,U.UL1B/NVE L1B 
GTR.PROC/RUNJOBS 

Edit file LGO to update the USER statement. 

2. Place the updated NVELIB in file DSTLIB on the user name from which you 
invoke NOS/VE. 

PURGE,DSTLIB/NA. 

DEFINE,DSTLIB/CT=PU. 

LIBEDIT,N-DSTLIB,U,1=0. 

RETURN,DSTLIB. 

The next invocation of NVE will use the RUNJOBS procedure stored in file 
DSTLIB. 

NOTE _ 

When upgrading NOS/VE in a dual state environment, any local modifications to file 
DSTLIB should be migrated to the new NVELIB prior to deadstarting the new 
NOS/VE level for the first time. Then the file DSTLIB should be purged or renamed. 
If this is not done, it is possible to use an old or incompatible NVELIB when 
deadstarting your new level of NOS/VE. 
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NOS ACCFILE 

The following template files are used by NOS/VE Interstate Communications and the 
NOS/VE commands PRINT_FILE, GET_FILE, REPLACE.FILE, and CREATE. 
INTERSTATE .CONNECTION to generate partner jobs that are submitted to NOS: 

ICACCNT Created in the ACCFILE procedure; used for interstate communications 
jobs and the CREATE.INTERSTATE.CONNECTION command. 

PRACCNT Created in the RUNJOBS procedure; used when the DUAL.STATE. 

ROUTE_PARAMETERS parameter is specified on the PRINT. FILE 
command. 

RHACCNT Created in the ACCFILE procedure; used for GET.FILE and 
REPLACE.FILE. 

These template files are created during NOS/VE deadstart. The released template files 
have the following partner job template: 

& JOB. 

USER, &USER, &PASSWORD, 8.FAMI L Y. 

CHARGE,&CHARGE,SPROJECT. 

Parameter Description 

&JOB The GET.FILE and REPLACE.FILE commands cause the 

following default command to be used: 

P.T5000. 

This job executes in the communication task service class. 

The CREATE.INTERSTATE.CONNECTION command uses the 
PARTNER.JOB.CARD parameter, if one was specified; 
otherwise, it uses the default job command: 

FASLAVE. 

This job executes in the batch service class. 

When the DUAL.STATE.ROUTE.PARAMETERS parameter is 
specified on the PRINT.FILE command, the following default job 
command (NOS/VE login user name) is used: 

username. 

This job executes in the communication task service class. 

Interstate communications does no substitution; a NOS job 
command must be supplied. 

&USER The user name value specified for the SET. LINK_ATTRIBUTES 

command is substituted. If the &ORGUSER field is used, the 
SET.LINK.ATTRIBUTES command is ignored. If no SET. 

LINK.ATTRIBUTES command is issued or the &ORGUSER field 
was used, then the current NOS/VE user name is used. 
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Parameter 

&PASSWORD 


&FAMILY 


&CHARGE 


&PROJECT 


Description 

The password value specified for the SET_LINK_ATTRIBUTES 
command is substituted. If no SET_LINK_ATTRIBUTES command 
was issued, then the current NOS/VE password is used. 

The family name value specified for the SET_LINK_ATTRIBUTES 
command is substituted. If the &ORGFAMILY field is used, the 
SET_ LINK _ ATTRIBUTES command is ignored. If no SET_LINK_ 
ATTRIBUTES command is issued or the &ORGFAMILY field was 
used, then the current NOS/VE family is used. If the family name 
is NVE, then the NOS family under which the NVE subsystem is 
executing is substituted. 

The value specified by the CHARGE parameter of the SET_LINK_ 
ATTRIBUTES command is used. If the &ORGCHARGE field is 
used, the SET_LINK_ATTRIBUTES command is ignored. If no 
SET_LINK_ATTRIBUTES command was issued or the 
&ORGCHARGE field was used, then substitution depends on the 
NOS/VE user’s project required validation. If this validation is true, 
the NOS/VE user’s account name is substituted. If this validation is 
false, then the two characters *. (asterisk period) are substituted. 

The value specified by the PROJECT parameter of the SET_ 
LINK_ATTRIBUTES command is used. If the &ORGPROJECT field 
is used, the SET_LINK_ATTRIBUTES command is ignored. If no 
SET_LINK_ATTRIBUTES command was issued or the 
&ORGPROJECT field was used, then substitution depends on the 
NOS/VE user’s project required validation. If this validation is true, 
the NOS/VE user’s project name is substituted. If this validation is 
false, then a blank character is substituted. 
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NOS ACCFILE Modification 

You may want to modify the partner job templates in the procedures ACCFILE and/or 
RUNJOBS, for example, to modify these job templates for local accounting or for 
taking out the &FAMILY if you are running with one family on NOS. If the &FAMILY 
is left in and if the family defined for your site for NOS is different from the family 
NOS/VE, then each user must enter a SET_LINK_ATTRIBUTES command in order to 
execute any dual state commands (GET_FILE, REPLACE_FILE, CREATE_ 
INTERSTATE_CONNECTION). To change the ACCFILE or RUNJOBS procedure, 
follow these general steps: 

1. Modify the Dual State Source Library on NOS/VE. 

2. Convert the library to text. 

3. Move the converted library to NOS and rebuild dual state. 

4. Create a new deadstart tape. 

As an alternative to the above method, you can use the following general steps to 
temporarily change the job templates: 

1. Modify the ACCFILE and/or RUNJOBS procedure in the ULIB NVELIB. 

RETURN,SYSTEM,OLD,LGO,DSTLIB. 

COMMON,SYSTEM. 

GTR,SYSTEM,OLD,U.ULIB/NVELIB 
GTR.PROC/ACCFILE.RUNJOBS 

Edit file LGO to update the job templates. 

2. Place the updated NVELIB in file DSTLIB on the user name from which you 
invoke NOS/VE. 

PURGE,DSTLIB/NA. 

DEFINE,DSTLIB/CT=PU. 

LIBEDIT,N=DSTLIB,U,I=0. 

RETURN,DSTLIB. 

The next invocation of NVE will use the new procedures stored in file DSTLIB. 

: NOTE _ 

1 When upgrading NOS/VE in a dual state environment, any local modifications to file 
| DSTLIB should be migrated to the new NVELIB prior to deadstarting the new 
| NOS/VE level for the first time. Then the file DSTLIB should be purged or renamed. 

| If this is not done, it is possible to use an old or incompatible NVELIB when 
| deadstarting your new level of NOS/VE. 
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FDBF - FORTRAN Data Base Facility Version 1 

This section describes the following: 

• Product Dependencies 

• Unique Parameters 

Product Dependencies 

The installation tool SYNGEN, which resides on the DDL 3 program library, must be 
available for the installation of FORTRAN Data Base Facility (FDBF) 1. 

Unique Parameters 

Parameter Description 

FTN4 To specify that FORTRAN 4 is the default language rather than 

FORTRAN 5, specify the keyword FTN4 on the call to FDBF. 
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FSE - Full Screen Editor 

T his section describes the following: 

• FSEEX and SMFEX Implementations 

• SMF Procedure File 

• Installation Parameters 

• Site-Defined Teach File 

• SYSGEN Functions for FSE 

• SMFSTAT Procedure 

FSEEX and SMFEX Implementations 

There are two implementations for FSE: FSEEX and SMFEX. The FSEEX program is 
a complete implementation of the editor and is called by the user with entry point 
FSE. The SMFEX program is a NOS subsystem, called by an operator, which 
implements a subset of the editor with performance characteristics different from 
FSEEX. 

When the SMFEX subsystem is enabled, the operating system automatically processes 
a large portion of the user’s FSE calls through SMFEX. When SMFEX is disabled, 
the FSEEX program is automatically scheduled with compatible external features. 
Where the NOS scheduler would process the FSEEX field length of approximately 
500008 words, the SMFEX scheduler processes approximately 3000s words. SMFEX 
can process editing transactions most effectively if the hardware configuration 
provides extended memory in the amount of 30008 words per editing user. Extended 
memory can be ECS, STORNET, ESM, LCME, or UEM. SMF can function without 
adequate extended memory, but it functions less efficiently. When SMFEX is 
operating, it uses a dedicated control point with a central memory (CM) field length 
typically ranging from 540008 to 700008 words. If the configuration provides user 
access to extended memory, SMFEX also uses a dedicated extended field length whose 
size is as much extended memory as is available, up to a limit determined by 
installation parameter NUMSWPECS. 

In summary, the decision to enable or disable SMFEX is a tradeoff between the 
following choices: stand-alone FSEEX which uses a large resource per user, or 
combined FSEEX plus SMFEX which uses a large fixed resource with a small 
incremental resource for each user. 

SMFEX is likely to improve overall performance if the hardware configuration 
provides at least 512K words of memory, including some form of extended memory, 
and if the workload includes at least 40 users simultaneously calling FSE. SMFEX is 
likely to degrade overall performance if the configuration provides 13 IK or smaller 
central memory, or if fewer than 20 users call FSE simultaneously. 

For configurations of 262K central memory and 20 to 40 editor users, SMFEX can be 
expected to improve response times for those users who call the editor, but can either 
improve or degrade overall system performance. To evaluate the value of SMFEX, it 
is suggested that medium-size sites experiment by operating SMFEX on alternate 
days. 
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SMF Procedure File 


Refer to Subsystem Initiation, at the beginning of this chapter, for information 
the subsystem startup files and SMF subsystem 


initiation. 


Minimally, a procedure file for initiating SMF must include the following: 

•PROC.SMFffff. 

SMFEX. 

0MB. 

SMFEX,RECOVER. 

SKIP,EXIT. 

EXIT. 

DMB. 

OMD. 

DMD,3777777. 

SMFEX,RECOVER. 

ENDIF,EXIT. 


The sequence of DMB, EXIT, and SMFEX,RECOVER commands is mandatory for valid 
subsystem shutdown and abort processing. 

The first SMFEX command may be modified to be of the form: 

SMFEX,n. 


where n is an integer from 2 to 8. This parameter determines the number of functions 
that can execute in parallel. The default is 3. Values of 3 or 4 are advisable for most 
sites. A guideline for selecting the value of n is one unit for every 25 users who 
simultaneously call FSE. Each increment in the value of n increases the central 
memory field length by approximately 40008 words. 

The SMFffff procedure can control the amount of extended memory allocated, by 
preceding the first SMFEX command with: 

MFL,EC=m. 


where m is the extended memory field length in units of 10008 words. 

Because SMFEX uses constant field lengths once it is fully initialized, it is advisable 
to select a control point number for the ENABLE command, which is either low or 
high. SMF then resides at one end of central memory and has minimal effect on the 
storage move characteristics of the NOS job scheduler. 
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Installation Parameters 

The following parameters are defined in deck COMFSMF. 

Parameter Default Description 

NUMSMFUSR 100 Maximum number of users that can be processed by 

SMFEX. NUMSMFUSR need not equal the maximum 
number of users who call FSE, since FSEEX is 
processed by the NOS scheduler when SMFEX 
overflows. If this parameter is increased beyond 100, the 
entire operating system must be reassembled with 
MXLF (in deck PPCOM) redefined, so that SMFEX can 
allocate additional negative field length for local FNT 
entries. NUMSMFUSR cannot be increased beyond 500. 

NUMSWPECS 100 Maximum number of users that can be processed using 

extended memory. The extended field length is 

approximately 3000s words per user. This field length 
can be reduced at subsystem initiation by providing less 
extended memory or no extended memory in the 
EQPDECK. NUMSWPECS should not exceed 
NUMSMFUSR, and need not equal NUMSMFUSR since 
SMFEX will use mass storage devices for overflow. 

Site-Defined Teach File 

If you want to define an FSTEACH file different from the released FSTEACH file, 
create the file and place it on user name LIBRARY. The file should be named the 
model name of the terminal used at your site prefixed by the letter T. For example, 
for a 722 terminal, name the file T722. 

FSE responds to a TEACH command by looking for a file whose name is the current 
terminal model name prefixed by a T (for example, T722 for a 722 terminal) on user 
name LIBRARY. FSE uses this file as FSTEACH. If no T file is found, FSE uses 
FSTEACH by default. 

SYSGEN Functions for FSE 

FSE is released with four files: FSEHELP, FSTEACH, FSEPROC, and SMFSTAT. The 
first three files are automatically stored under user name LIBRARY; SMFSTAT is 
stored under the installation user name. 


7-102 NOS Version 2 Installation Handbook 


Revision L 



FSE - Full Screen Editor 


SMFSTAT Procedure 

FSE installation creates an indirect access permanent file on the installation user name 
that contains a procedure called SMFSTAT. This procedure provides some statistics for 
the Screen Management Facility (SMF). 

The SMF subsystem must be executing for SMFSTAT to run successfully To use the 
SMFSTAT procedure, do the following: 

1. Log in to IAF under the installation user name. 

2. Enter this command: 

BEGIN,.SMFSTAT. 

FSE comes up, and you may then enter the GET DATA (GD) directive. If SMF is 
not executing or if the SMFSTAT procedure is executed in a noninteractive job, 
this directive has no effect. Otherwise, the GD directive obtains some statistic 
words from the editor’s field length. Enter the QUIT (Q) directive to terminate 
this edit session. This starts up a FORTRAN program to analyze the results of 
the statistics obtained from the GD directive. The program displays a preliminary 
report on the screen and provides a more detailed report on a local file called 
STATOUT. 

3. Either route the STATOUT report to the printer or view it using FSE. 
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FTN4, FTNTS, FTN5 (FORTRAN Extended 
Version 4, FORTRAN Extended Version 4 with 
Interactive Option, FORTRAN 5) 

This section describes the following: 

• MODEL Parameter 

• Installation Parameters for FTN4 and FTNTS 

• Installation Parameters for FTN5 

MODEL Parameter 

FTN4, FTNTS, and FTN5 reference the MODEL parameter (refer to the TEXT and 
TEXTIO section in this chapter). Whether a computer efficiently executes the 
FORTRAN object code that it produced depends upon the model of the computer and 
the value specified in the MODEL parameter. If the value specified in the MODEL 
parameter is identical to the computer’s model number, the object code executes 
efficiently. If the value specified in the MODEL parameter is different from the 
computer’s model number, the object code executes inefficiently or not at all. 

Installation Parameters for FTN4 and FTNTS 

Depending on the installation parameters of interest, you can obtain a listing of the 
parameters by assembling FTNMAC or FTNTEXT (the FTNMAC listing is much 
shorter) and/or FTN. FTN contains the installation parameters for the default command 
settings, command error processing, default file names, input/output buffer length, 
overlay library names, and reduce mode field length increments. The remaining 
parameters are in OPTIONS (called by FTNMAC/FTNTEXT). 

Installation Parameters for FTN5 

Depending on the installation parameters of interest, you can obtain a listing of the 
parameters by assembling FTN5TXT and/or FTN. FTN contains the installation 
parameters for default command settings, command error processing, default file names, 
input/output buffer length, and compiler overlay library names. The remaining 
parameters are in OPTIONS (called by FTN5TXT). 

Reinstall the compiler and CCG whenever you change parameters in OPTIONS (refer 
to the Build Dependency Chart in chapter 6). You can revise installation parameters 
in COMFCIP during the installation of FTN5, if you reassemble both FTN and 
INITOO. 
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IAF - Interactive Facility Version 1 

This section describes the following: 

• Installation Parameters 

• IAF Procedure File 

• Special Notes 

Installation Parameters 


The following parameters, defined in deck IAFEX, specify default values for the 
Application Interface Program (AIP) Trace utility in IAF. 


Parameter 

Default 

Description 

DMCT 

16200 

Maximum number of messages logged before the trace 
file is released to the system for processing. 

MXML 

10 

Maximum length in central memory words of a 
message logged on the trace file. 

TJOB 

TRACIAF 

Micro whose string specifies the name of the 
procedure file containing the job commands used to 
process the trace file. 

IAF Procedure File 



Refer to Subsystem Initiation, at the beginning of this chapter, for information about 
subsystem startup files and subsystem initiation. IAF initiation consists of these three 
procedures: IAF, IAFTM, and IAFTR. 

When IAFTM or IAFTR is used, it stores a copy of TRACIAF under SYSTEMX (user 
index 377777s) for subsequent use. For additional information regarding the trace 
utility, refer to the NOS Version 2 Analysis Handbook. 

NOTE 


The composite OPL deckname for the IAF procedure is IAFP. 
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Special Notes 

• RDFEX and IAF share the decks IAFEX and 1TM in the composite OPL 
(OPLpsrout). Both products must be rebuilt if user code is applied to either of 
these decks, and the user code must be included with both the RDFEX and IAF 
build procedures. 

• Procedure file TRACIAF, which uses a NETOPS USER command and the default 
CHARGE command, contains commands to process the trace file. Modify TRACIAF 
only if you need to change the USER and CHARGE command parameters. Modify 
decks IAFTM and IAFTR and place the modifications on a USER file. 

• Two additional procedures exist to enable the console operator to select the type of 
trace, according to the parameter specified on the IAFEX command. In procedure 
IAFTM, T=* is the parameter on the IAFEX command; it causes the trace file to 
be processed only when IAF has terminated. In procedure IAFTR, T is the 
parameter on the IAFEX comand. The T parameter causes the trace file to be 
submitted as an input job using the TRACIAF file for the command record after 
every 16,200 messages have been logged on the trace file. Refer to the NOS 
Version 2 Analysis Handbook for a description of the IAFEX command. 
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ITF - Interactive Transfer Facility Version 1 

This section describes the following: 

• Product Dependencies 

• ITF Command 

ITF provides NOS interactive terminal users access to computer systems linked by a 
loosely coupled network (LCN) through the Remote Host Facility (RHF) subsystem. ITF 
multiplexes one or more network terminal connections through an 
application-to-application RHF connection to each remote host servicer application 
(ITFS). ITFS is provided only on the CYBER 200 VSOS operating system. 


Product Dependencies 

ITF serves as an application program to both the network access method (NAM) and 
RHF subsystems. ITF is initiated by NAMI using the NAM startup master file and 
remains connected to the NAM subsystem until either NAM is terminated or the NAM 
network operator commands IDLE or DISABLE are used. ITF remains connected to the 
RHF subsystem as long as there are interactive users connected to ITF. 

Before you execute the ITF installation procedure, the NAM5, RHC, and RHF 
installation procedures must complete successfully. The ITF installation procedure 
modifies the NAM startup master file which is created by the NAM5 procedure on 
the installation user name. After all products that modify this file are installed, you 
can use the SYSGEN(MOVE) command to move the startup master file to the proper 
user name (refer to the NAM5 section in this chapter). The released default JOBITF 
record, which is added to the startup master file, includes the following command to 
call ITF: 

ITF. 

If you want to add any optional parameters to the ITF command (see ITF Command in 
this section), you can either use a text editor to modify the startup master file or add 
Update directives to a USER file for the ITF installation procedure. 

Before using ITF, you must ensure that the LCF section of the NDLP input for the 
NAM network configuration includes the following statement (refer to the Network 
Definition Language Version 1 Reference Manual for a complete description): 

ITF: APPL,PRIV. 

You must also ensure that the RCFGEN input for the RHF network configuration 
correctly defines all NPID, PATH, and RNAD entries for all remote hosts and includes 
an APPL directive for ITF similar to the following (refer to Configuration Information 
in the RHF section of this chapter): 

APPL NAME=ITF,MXCONS=2,MXCOPYS=1 

The value of the MXCONS parameter must not be less than the value of the PI 
parameter on the ITF command. 
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ITF Command 

Here is the format for the ITF command: 

ITF(ML=ml,DL=dl,MA=ma,PI=pi,TE=te,CO=co) 

P arameter Description _ 

CO = co The maximum number of terminals connected per remote host. This 

value can range from 1 through 128. Default is 64. 

DL=dl The default LID for ITF connections. If ML=ml is omitted, dl is the 

default LID used by the system if the user does not enter a LID. dl 
must be defined in the CMR LID table. If DL=dl is omitted, ITF 
continues to request a LID from the user. Default is no LID. 

MA = ma The mandatory application to which users are switched when the 

connection terminates, ma must be 1 through 7 alphanumeric 
characters and can be the name of any NAM application installed in 
your system, or it may be an NVF command such as LOGOUT. If 
MA = ma is omitted, ITF prompts the user for another LID or 
application. If MA = LOGOUT is specified, users are logged out. Default 
is no application or command. 

ML = ml The mandatory logical identifier (LID) for ITF connections. If ML = ml 

is omitted, each user is prompted to enter a LID. If specified, ITF 
automatically attempts to connect each user to the specified LID. ml 
must be defined in the CMR LID table. Default is no LID. 

PI = pi The maximum number of remote hosts to which ITF may 

simultaneously connect, pi can range from 1 through 7 and must be 
less than or equal to the value of the MXCONS parameter on the 
RHF configuration file APPL directive for ITF. Default is 2. 

TE = te The maximum number of interactive terminals that can connect to 

ITF. This value can range from 1 through 128. Default is 128. 

The PI, TE, and CO parameters are constrained by the definitions of symbols 
MAXACN (released value = 2) and MAXTCN (released value = 64) in ITF common 
deck COMITBLS. The following relation exists: 

0 < PI < MAXACN 

0 < CO < MAXTCN 

0 < TE < MIN(PI,MAXACN)‘MIN(CO,MAXTCN) 

If any parameter is not specified or is not in range, it is set to the maximum allowed. 

The following space is allocated in common block COMITBLS at compile time: 

(2‘MAXACN) + (MAXACN*MAXTCN) words 

The space is allocated along with a variable number of buffers as needed to transfer 
data between the terminal and the remote host servicer. These tables and buffers are 
dynamically allocated and released under control of the Common Memory Manager. 
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LCS3 and FCS3 - Conversion Aids System Version 3 


The Conve rsi ° n Aids System includes the Language Conversion Aids System (LCS) and 
LCS3 C ° nVerSi0n AidS Sy$tem (FCS) - This section Ascribes USER file directives for 


USER File Directives for LCS3 

The tables of the FORTRAN and COBOL language conversion processors (LCPs) may 

overflow when programs with large numbers of symbols or with lengthy statements are 
processed. 


The FORTRAN LCP name table contains a fixed-size entry for each name that 
appears in a declarative statement. The COBOL LCP name table contains a 
variable-size entry for each special name, file name, and data name, except within 
either an RD entry in the Report Section or an SD entry in the File Section. COBOL 
name table entries are 4 + (n + 9)/10 words long (n is the number of characters in the 
name), with no rounding up. For example, if n = 4, the name table entry is 5 words; 
if n = 20, the name table entry is 6 words. 

You can enlarge these tables by including either of the following Update directives on 
a USER file in the installation procedure for LCS3. 

•DEFINE LTAB 
•DEFINE LTAB.XLTAB 

Table sizes and central memory requirements are shown in table 7-7. 


Table 7-7. Table Sizes and Central Memory Requirements 


No 'DEFINE 

LCP Name Table 

Default 

♦DEFINE 

LTAB 

'DEFINE 

LTAB.XLTAB 

FORTRAN 




Table size 

300 entries 

600 entries 

- 

Minimum central 
memory required 

610008 words 

650008 words 

- 

COBOL 




Table size 

3200 words 

7000 words 

13000 words 

Minimum central 
memory required 

600008 words 

700008 words 

1060008 words 
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To create a special version of the LCS that includes the copy processing logic and 
additional CRM routines, make the following Update directive available on a USER file 
when the LCS3 installation procedure is run. 

•DEFINE CBLCOPY 

The central memory requirements for this version of the LCS are increased by 
approximately 20400s words. 

To create a special version of the LCS that generates COBOL sequence numbers in 
increments of 1 (the default is 10), make the following Update directive available on 
a USER file when the LCS3 installation procedure is run. 

•DEFINE COLUMN6 

The central memory requirements for this version are increased by 5 words. 
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LOADER - CYBER LOADER Version 1 

This section describes the following: 

• Unique Parameters 

• Installation Parameters 


Unique Parameters 

Parameter_ Description 


PRESET 


MAP 


The PRESET parameter sets the default central memory presetting 
options. The default presetting for the binaries you receive depends 
on the information you provided in the OIP. The default for this 
parameter is ZERO. If the PRESET parameter is specified on the 
LDSET command, it will override this default setting. The value 
NONE requires no presetting; same as ZERO for CM. 


Value 


Preset 

(Octal) 


NONE 

_ 

_ 




ZERO 

0000 

0000 

0000 

0000 

0000 

ONES 

7777 

7777 

7777 

7777 

7777 

INDEF 

1777 

0000 

0000 

0000 

0000 

INF 

3777 

0000 

0000 

0000 

0000 

NGINDEF 

6000 

0000 

0000 

0000 

0000 

NGINF 

4000 

0000 

0000 

0000 

0000 

ALTZERO 

2525 

2525 

2525 

2525 

2525 

ALTONES 

5252 

5252 

5252 

5252 

5252 

DEBUG 

6000 

0000 

0004 

0040 

0000 

This parameter sets the default LOADER MAP 

option. The default 

is OFF. If the MAP parameter is specified on the LDSET command 

or the MAP command is used, it will 

override this default setting. 

Value 

Description 





OFF 

No map 






PART 

ON 

FULL 


Statistics, block map 
Statistics, block map, entry point cross-reference 
Statistics, block map, entry point map, entry point 
cross-reference 
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Parameter Description 


x cul aiuvvvi. 

FLMSG 

This parameter determines if LOADER issues a dayfile message 
indicating the field length required for loading and execution. The 
default is YES. 

Value Description 


NO 

Dayfile message is not issued 


YES 

Dayfile message is issued 

NOTE 




When building LOADER, do not add code to set the symbols IP.PSET, IP.MAP, or 
IP.FLMSG, because these are set by the above parameters. 


Installation Parameters 

You can change the following parameters for LOADER. Insert the parameter changes 
at LDRCOM.13 in Update. 


Parameter 

Default 

Description 

IP.FLINC 

4000B 

Amount of field length increase if additional field length 
is required for table construction by LOADER. 

Acceptable values are multiples of 1008- 

IP.LDBG 

0 

If nonzero, conditional code to aid in debugging the 
loader is assembled. 

IP.LDER 

1 

Error processing by the loader; one of the following 


values. 

Value Description 


0 Abort on all errors (ERR = ALL). 

1 Abort on fatal errors (ERR=FATAL). 

2 No abort if abort is possible (ERR=NONE). 

IP.LRT 0 If nonzero, a message giving various time and memory 

measurements is issued to the dayfile. 

IP.REW 1 Specifies whether the file is rewound prior to beginning 

of load; one of the following values. 

V alue Description _ 

0 File is not rewound. 

1 File is rewound. 

LOADER also uses the symbol IP.MECS, which is defined in IPARAMS during the 
installation of TEXT and TEXTIO. 
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MAP Subsystem 

This section describes the following: 

• MAP Installation Procedures 

• MSSI Validation Requirements 

• Procedures for Initiating MSSI 

MAP Installation Procedures 

There are four DECKOPL installation procedures for installing the MAP subsystem: 
MSSI, MMCL, AP1I, and AP1L. These procedures build the MAP subsystem, the MAP 
microcode to support MAP III, MAP IV-20/21, and MAP IV-23/25, as well as online 
diagnostics. 

The MAP subsystem procedures and their build parameters are as follows: 


Procedure 

Build Parameter 

API I - Online diagnostics 

MEMSIZE 

AP1L - Online diagnostics 

MAPTYP, ADD, MUL, DIV, SQRT 

MMCL - Macro control library 

None 

MSSI - MAP subsystem 

BLDMLIB, MSAMLIB 

The MSSI procedure must be run before the AP1I procedure. Refer to the MSSI 
Version 3 Installation Handbook for complete installation information. 

NOTE 


The MSSI procedure requires 20K of ECS/UEM and the AP1I procedure requires 70K 
of ECS/UEM. 


MSSI Validation Requirements 

The SYSGEN installation procedure for installing MSSI requires the user names 
CDCCE and CDCCE2 (these user names can be changed, but they must be unique). 
The released passwords for the user names are the same as the user names; however, 
you can change the user names or passwords. 

In the subsystem startup procedures MAPCMI, MAPECS, and MAPCH, a CCL .DATA 
file contains the directives: 

AP1UN=username 

AP1PW=Dassword 

To change the user name or password, replace the parameter values username and 
password with the new user name and password. 
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Procedures for Initiating MSSI 

Control Data provides three procedure files for initiating MSSI: 
MAPCH for initiating MAP IV-20/21 
MAPCMI for initiating MAP IV-23/25 
MAPECS for initiating MAP III 
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MCS - Message Control System Version 1 

This section describes the following: 

• Unique Parameters 

• Installation Parameters 

• MCS Procedure File 

• Special Notes 


Unique Parameters 


Parameter Description 


TRACE 


To activate the MCS debug facility, specify the keyword TRACE on the 
call to the MCS installation procedure. 


Installation Parameters 


The following parameters are defined in common deck IPA$MCS. To change these 
parameters, place the appropriate Update directives in a USER file for the MCS 
installation procedure. 


Parameter 

MAXFL 

OUTLIMIT 


Default Description 

110000 Maximum field length (octal) to which MCS can expand. 

60 Number of messages that can accumulate in an output 

queue before SEND requests are rejected. 


The following parameters assign relative weights to the various requests that a COBOL 
program can make to MCS. When the program disconnects from MCS, the accounting 
routine adds the corresponding weight factors of all requests and enters the total into 
the system account file. 


Parameter Default 

AC$ACCEPT 1 

AC$CHECKPT 1 

AC$DISABLE 1 

AC$ENABLE 1 

AC$INITIAL 2 

AC$PURGE 2 

AC$RECEIVE 3 

AC5SEND 3 

AC$STOPRUN 2 


Value COBOL Request 
Accept. 

Checkpoint. 

Disable. 

Enable. 

Initial. 

Purge. 

Receive. 

Send. 

Stop run. 
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MCS Procedure File 

I Refer to Subsystem Initiation, at the beginning of this chapter, for information about 
1 the MCS subsystem startup procedure and subsystem initiation. 

NOTE ___ 

When MCS is started by the NAMI master startup file, the ENABLE and DSD 
AUTO commands are not applicable to MCS. 


Parameters in the procedure control the following aspects of MCS initialization. 

• Default user name and family. 

• Default Application Definition Language (ADL) file name. 

• Operator interaction. 

The default user name for MCS is SYSTEMX. To change the user name, insert a 
USER command in the procedure that specifies the user name and family under which 

MCS is to run. 

To change the default ADL file, include an ATTACH or GET command in the 
procedure so that the local file name ADLLIB exists before MCS is called. If file 
ADLLIB does not exist locally, MCS tries to acquire a file with the name ADLLIB 
under either the default user name or the name specified with the USER command. 

Inclusion of a GO parameter on the MCS program call command prevents operator 
interaction during MCS initialization. 

The released MCS startup procedure attaches ADLLIB from the installation user 
name and starts MCS automatically. 
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Consider the following two procedures. 

Example 1: 

J>ROC,MCS. 

RETURN,MCS. 

RFL,60000. 

MCS,GO. 

EXIT. 

REWIND,2ZZZZDN. 

DLFP,1=0. 

Example 2: 


.PROC,MCSTEST. 

USER,username,password,fami 1yname. 

RFL,60000. 

ATTACH,ADLLIB/UN=username. 

MCS. 

EXIT. 

REWIND,ZZZZZDN. 

DLFP,1=0. 

Example 1, the procedure named MCS, specifies the default user name (SYSTEMX) and 
the default ADL file (ADLLIB); it does not allow the operator to change initialization 
parameters. 

Example 2, the procedure named MCSTEST, specifies a different user name, family 
name, and ADL file and allows the operator to change initialization parameters. 

The call to DLFP is required only if you use a debug version of MCS. 


Special Notes 

• To activate debug dumps for the ADL processor, include a *DEFINE DEBUG 
directive in a USER file for the MCS installation procedure. 

• Users must be validated to access MCS (refer to MODVAL in the NOS Version 2 
Administration Handbook). 
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MSE - Mass Storage Extended Subsystem 

This section describes the following installation options for MSE. 

• Unique Parameters 

• Configuration Information 

• Common Deck Parameters 

Unique Parameters 

Parameter Description _____ 

SAVELIB To save M86LIB as a direct access file, specify the keyword SAVELIB on 
the call to the MSE installation procedure. 

Configuration Information 

To configure the Mass Storage Extended (MSE) subsystem, create the following: 

• MSECONF file. This file defines the components of your 7990 configuration. Some 
of the statements in the file reference your EQPDECK entries for the 7990. The 
MSECONF file is stored as a direct access file on user name SUBFAMO (user 
index 377760B). A sample MSECONF file is provided with the release materials. 
This file should be edited on the installation user name then moved to user name 
SUBFAMO. 

For a first-time installation, ATTACH the example file from user name SUBFAMO 
directly. If you are installing MSE for the first time during an upgrade or 
component order installation, execute the SYSGEN(MSEl) procedure from the 
installation user name to load a copy of the MSECONF, MSE, and MSESLAV files 
to the installation user name. 

To move the MSECONF file to user name SUBFAMO, execute the command 
SYSGEN(MOVE,MSECONF,SUBFAM0„Y,PERMIT) from the system console when 
directed to in chapter 2, 3, or 4. 

• SS EQPDECK entry. This entry defines the connection of the 7990 controller to 
your mainframe. 

® MSE startup procedures. These procedures define how the MSE subsystem should 
be initiated. Two procedures are released: one for executing MSE in a single 
mainframe environment (file name MSE) and one for executing MSE in slave 
mode in a multimainframe environment (file name MSESLAV). The MSE startup 
procedures are indirect access files stored on user name SYSTEMX (user index 
377777B). These files should be edited on the installation user name then moved 
to user name SYSTEMX. 

For a first-time installation, GET the example files from user name SYSTEMX 
directly. If you are installing MSE for the first time during an upgrade or 
component order installation, execute the SYSGEN(MSEl) procedure from the 
installation user name to load a copy of the MSE, MSESLAV, and MSECONF files 
to the installation user name. 

To move either file to user name SYSTEMX, execute the command 
SYSGEN(MOVE,filename,SYSTEMX„Y,PERMIT) from the system console when 
directed to in chapter 2, 3, or 4. 
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MSE - Mass Storage Extended Subsystem 


The file PFGMSE1 on the permanent file tapes contains the MSECONF, MSE, and 
MSESLAV files. For more information about the MSE configuration file, SS EQPDECK 
entry and MSE startup procedures, refer to the Mass Storage Extended Subsystem and 
Deadstart Decks sections in the NOS Version 2 Analysis Handbook. 


Common Deck Parameters 


COMBFAS Parameters 

COMBFAS contains the following parameters used by the MSE executive (SSEXEC). 
Assemble CALLFAS to obtain a listing of COMBFAS. 


Parameter 


Default Description 


MAXCHERR 2 

MAXCTUNIT 1 

MAXSMM1 1 

MAXSMUNIT 2 


Number of channel errors allowed per hour. 

Number of controllers allowed in the Unit Device Table. 
Maximum is 8. 

Must equal MAXSMUNIT - 1. 

Number of storage modules allowed in the Unit Device 
Table. Maximum is 8. 


COMXIPR Parameters 

COMXIPR contains the following parameters used by the MSE executive (SSEXEC). 
Assemble CALLFAS to obtain a listing of COMXIPR. 


Parameter 


Default Description 


NUMRB 


NUMSLV 


SLAV$INTV 


SLRP$INTV 


60 


The number of file staging request blocks available to a 
slave mainframe. 

The number of slave mainframes for which master 
SSEXEC can service file staging requests. 

The number of seconds SSEXEC waits with no signal 
from a slave mainframe before assuming that the slave 
executive has terminated. 

The number of seconds SSEXEC waits to look for new 
staging requests from slave mainframes. 
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NAM5/NAM5D - Network Access Method Version 1 

This section describes the following installation options for NAM: 

• Configuration Information 
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Unique Parameters 

Parameter Description ___ 

NOTRACE To disable trace/log file creation for CS, NS, NVF, and TVF, specify the 
keyword NOTRACE on the call to the NAM5 procedure. (This option is 
not available for NAM5D.) 


NAM Procedure File 

Refer to Subsystem Initiation, at the beginning of this chapter, for information about 
the NAM startup procedure file and subsystem initiation. 

There are two released initiation procedure files: NAM and NAMNOGO. Use the 
NAM procedure to initiate NAM without operator intervention; use the NAMNOGO 
procedure when operator intervention is required. 

A NAM procedure file causes the network initialization program NAMI to execute. 
NAMI takes input from a permanent file which it creates the first time it executes 
(under user name SYSTEMX), from its command parameters, and from the operator 
through CFO commands. Command parameters override the permanent file; operator 
entries override both the command parameters and the permanent file. 

The parameters to the NAMI command primarily identify a startup master file that 
NAMI uses to bring up network host programs. A GO parameter on the NAMI 
command brings up the network without operator intervention. This parameter is 
provided on the NAMI command in the NAM procedure, but it is absent in the 
NAMNOGO procedure. 

The first time the network programs are to be started, you should enter NAMNOGO 
to allow entry of the parameters necessary for it to execute. These parameters are 
the name of the startup master file, the user name and password under which the 
file resides, and the name of the parameter record on the master file containing 
additional directives to NAMI for starting the network programs. Enter the required 
parameters through the CFO command, ending with the GO parameter to start NAMI 
processing. Refer to the NOS Version 2 Analysis Handbook for a description of the 
NAMI command and for further details on NAMNOGO and the CFO command. 

The released startup master file, NAMSTRT, is a multirecord file containing six 
parameter records (INIT, MINIT, MRECOV, MULTI, RECOVR, and RESTRT) and 
seven job records (JOBCOL, JOBCS, JOBNIP, JOBNS, JOBNVF, JOBPUR, and 
JOBTVF). For the initial NAM startup, you should specify the parameter record INIT 
for a single host network or MINIT if your network contains more than one host. 
Subsequent entries of NAM from the console cause NAMI to use the parameter 
record RESTRT. If you have a multihost network, you should change the NAMI 
command in the NAM procedure file so that subsequent entries from the console use 
the parameter record MULTI. 

The INIT record directs NAMI to route to the input queue jobs to start the programs 
COLLECT, CS, NS, NVF, and TVF. NIP is started at the NAMI control point. 
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The release materials contain a sample NDL file, NDLDATA, which is installed to 
the network administration user name. This file defines a simple one-NPU network 
that includes the definitions for the PSU printer and all CDCNET applications. This 
file may be examined by logging in to the network administration user name or by 
executing SYSGEN(NDLl) from the installation user name to load NDLDATA (and 
the compiled version of NDLDATA, NCFFILE and LCFFILE) to disk. 

To compile an NDL, execute the following steps: 

1. Log in to the network administration user name and update NDLDATA using 
an available editor. Leave NDLDATA local and rewound. 

2. If you are updating the NDL as part of a system upgrade (and have therefore 
not deadstarted the system containing the new level of NDLP), access the new 
version from GLOBLIB: 

ATTACH,GLOBLIB/UN=insun. 

LIBRARY.GLOBLIB/A. 

3. Make permanent files to receive compiled NCFFILE and LCFFILE. 

PURGE,NCFTEMP,LCFTEMP/NA. 

RETURN,NCFFILE.LCFFILE. 

DEFINE,NCFFILE=NCFTEMP,LCFFILE=LCFTEMP. 

PERMIT,NCFTEMP,netopun=R. 

PERMIT,LCFTEMP,netOPun=R. 

4. Execute NDLP: 

NDLP,I=NDLDATA,L=1iSting. 

Replace listing with the name of the file to receive the NDLP output. 

RETURN,NCFFILE.LCFFILE. 

5. Change the temporary names for the NCFTEMP and LCFTEMP files in Step 6 
of chapter 3 or 4, whichever is appropriate. Use the commands below: 

PURGE,NCFOLD,LCFOLD/NA. 

CHANGE,NCFOLD=NCFFILE,NCFFILE=NCFTEMP. 

CHANGE,LCFOLD=LCFFILE,LCFFILE=LCFTEMP. 

• EQ EQPDECK entry for CCP. This entry defines the connection of each 255x 
NPU to your mainframe. The ND parameter is referenced by the NODE 
parameter of the NDL COUPLER statement. 

• EQ EQPDECK entry for CDCNET. This entry defines the connection of each 
Mainframe Device Interface or Mainframe Terminal Interface to your mainframe. 
The ND and NT parameters are (optionally) referenced in CDCNET DI system 
configuration files. 

Refer to the Network Definition Language (NDL) Reference Manual for more 
information on the NDL and NDLP. Refer to the Deadstart Decks section of the NOS 
Version 2 Analysis Handbook for more information about the EQ EQPDECK entries. 
Refer to the CDCNET Configuration and Site Administration Guide for more 
information about CDCNET configuration files. 
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Site-Defined User Names 

£ 

If you are changing the default Control Data installation user names (in particular 
NETOPS or NETADMN), note the following: 

| • If the network administration user name is changed, file NAMSTRT must be 

altered. NAMSTRT contains a parameter called NETUN2 that determines where 
the system expects such files as NCFFILE, LCFFILE, NLFFILE, and TCPHOST. 
This example shows the line to change: 

PARAM(NETUN2=NETADMN) CONFIGURATION/LOAD FILE USER NAME. 

The NETUN2 parameter exists in the six basic NAMSTRT records 
(INIT-MRECOV). You must change it in each record that you use. 

| • If the network operations user name is changed, you must tell NAM what the 

new user name is the next time you initiate NAM (in Step 7: Deadstart the New 
System). This can be accomplished by two methods: 

1. If you moved NAMSTRT to the new network operations user name, NAM 
should ask for a CFO command when it is initiated. Enter the following 
commands from the system console: 

CFO,NAM.UN=netopun,PW=password. 

CFO,NAM.GO. 

These commands tell NAM the new user name on which NAMSTRT resides. 

2. If you did not move NAMSTRT to the new network operations user name, you 
must execute the NAMNOGO procedure to initiate NAM. This gives you the 
opportunity to tell NAM the new user name and password. Enter the following 
commands from the system console: 

CFO,NAM.UN-netopun,PW=password. 

| CFO,NAM.GO. 

These commands tell NAM the new user name on which NAMSTRT resides. 

\ In either case, NAM updates its files so that the next time it is brought up, it 
i: automatically finds NAMSTRT on the new network operations user name. 


7-122 NOS Version 2 Installation Handbook 


Revision L 



NAM5/NAM5D - Network Access Method Version 1 


Special Notes 

• The NAM installation procedure installs the following NAM components and 
utilities: 

AIP (Application Interface Program) 

COLLECT (Collect Network Dumps) 

CS (Communications Supervisor) 

DLFP (Debug Log File Processor) 

LFG (CCP Load File Generator) 

LISTPPM (Format PIP Memory Dumps) 

NAMI (Network Initialization Program) 

NDA (NPU Dump Analyzer) 

NDLP (Network Definition Language Processor) 

NIP (Network Interface Program) 

NS (Network Supervisor) 

NVF (Network Validation Facility) 

PIP (Peripheral Interface Program) 

QTRM (Queued Terminal Record Manager) 

TVF (Terminal Verification Facility) 

• NAM5 binaries are released on the deadstart tape in non-debug/trace mode. 

Control Data provides debug/trace mode binaries of NAM5 on the permanent file 
tapes. To obtain the debug/trace NAM5 binaries, use the SYSGEN(SWAP) function 
described in chapter 8. 

• The installation procedure retrieves the startup procedure and NAMSTRT files 
from the program library on NAM5. The installation procedure saves these files 
as public indirect access permanent files on the installation user name. Executing 
the SYSGEN (MOVE) utility automatically moves the files to SYSTEMX and the 
network operations user name. Other optional product installation procedures 
modify NAMSTRT (PSU, RBF, PTF/QTF with NAM interface, CDCNET Host 
Applications, TCP/IP/FTP/TELNET and ITF). Thus, you should not move 
NAMSTRT until these optional products have been installed. 

• The NAMI Host Application Programming Reference Manual describes AIP, CS, 
DLFP, NIP, NS, PIP, and QTRM. The NAM/CCP Terminal Interfaces Reference 
Manual describes TVF. The Network Definition Language Reference Manual 
describes NDLP. The NOS Version 2 Analysis Handbook describes COLLECT, 

LFG, LISTPPM, NAMI, NDA, and NVF. 

• There are execution time interdependencies between NAM and CCP. These 
interdependencies are established in file USERBPS (refer to CCP/CROSS in this 
chapter). 

• The flow of supervisory and data messages through the network is traced by 
Application Interface Program (AIP) code, which creates log files of such 
messages. The data that the log files provide is invaluable in the analysis of error 
conditions in network installation or operation. Startup jobs JOBCS, JOBNIP, 
JOBNS, JOBNVF, and JOBTVF save the log files as direct access permanent files 
on tape and purges them. For network problems, this tape (with other support 
materials) should be included with all PSRs submitted for network products. A 
more detailed description of the log file capability is in the NAMI Host 
Application Programming Reference Manual. 
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Unique Parameters 

Parameter Description 

NOTRACE To disable trace/log file creation for CS, NS, NVF, and TVF, specify the 
keyword NOTRACE on the call to the NAM5 procedure. (This option is 
not available for NAM5D.) 

NAM Procedure File 

Refer to Subsystem Initiation, at the beginning of this chapter, for information about 
the NAM startup procedure file and subsystem initiation. 

There are two released initiation procedure files: NAM and NAMNOGO. Use the 
NAM procedure to initiate NAM without operator intervention; use the NAMNOGO 
procedure when operator intervention is required. 

A NAM procedure file causes the network initialization program NAMI to execute. 
NAMI takes input from a permanent file which it creates the first time it executes 
(under user name SYSTEMX), from its command parameters, and from the operator 
through CFO commands. Command parameters override the permanent file; operator 
entries override both the command parameters and the permanent file. 

The parameters to the NAMI command primarily identify a startup master file that 
NAMI uses to bring up network host programs. A GO parameter on the NAMI 
command brings up the network without operator intervention. This parameter is 
provided on the NAMI command in the NAM procedure, but it is absent in the 
NAMNOGO procedure. 

The first time the network programs are to be started, you should enter NAMNOGO 
to allow entry of the parameters necessary for it to execute. These parameters are 
the name of the startup master file, the user name and password under which the 
file resides, and the name of the parameter record on the master file containing 
additional directives to NAMI for starting the network programs. Enter the required 
parameters through the CFO command, ending with the GO parameter to start NAMI 
processing. Refer to the NOS Version 2 Analysis Handbook for a description of the 
NAMI command and for further details on NAMNOGO and the CFO command. 

The released startup master file, NAMSTRT, is a multirecord file containing six 
parameter records (INIT, MINIT, MRECOV, MULTI, RECOVR, and RESTRT) and 
seven job records (JOBCOL, JOBCS, JOBNIP, JOBNS, JOBNVF, JOBPUR, and 
JOBTVF). For the initial NAM startup, you should specify the parameter record INIT 
for a single host network or MINIT if your network contains more than one host. 
Subsequent entries of NAM from the console cause NAMI to use the parameter 
record RESTRT. If you have a multihost network, you should change the NAMI 
command in the NAM procedure file so that subsequent entries from the console use 
the parameter record MULTI. 

The INIT record directs NAMI to route to the input queue jobs to start the programs 
COLLECT, CS, NS, NVF, and TVF. NIP is started at the NAMI control point. 

Based on JOB and PARAM statements in the INIT record, other network applications 
(CDCNET Host Applications, TCP/IP/FTP/TELNET, ITF, PSU, PTF/QTF with NAM 
interface, and RBF) are also routed to the input queue to begin execution. 
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USER File Directives 

To assemble the following features into NAM, include directives of the form 
•DEFINE name 

in a USER file for the NAM5 installation procedure, where name is one of the 
following values: 

Name Significance when Defined 

DEBUG Code to aid in debugging and maintenance in NIP and PIP is generated. 

The following list shows the effect of DEBUG on NAM components. 

• CS, NIP, NS, and NVF abort on certain error conditions. 

• CS, NS, and NVF are loaded with the debug version of AIP and produce 
network traces. 

• PIP hangs PPs for certain error conditions. 

• NIP uses internal trace buffers to trace messages sent and received and 
to trace subroutine and overlay calls. 

IMS Descriptive internal maintenance comments are included in the assembly 

and compilation listings. 

STAT Additional statistics-producing code is generated in AIP and NIP. With 
STAT defined, each time an application stops talking to the network, a 
terminal-to-application connection terminates, or an application-to-application 
connection terminates, statistical information is written to the NIP dayfile. 
After NIP terminates, the dayfile indicates the number of times each 
overlay was called and gives the statistics kept in common block STATTAB. 

The size of the job dayfile increases significantly when STAT is defined. 

ZZDN Code is generated to log all inbound or outbound messages between NIP 
and PIP in local file ZZZZZDN. 

NOTE _ 

You should be thoroughly familiar with NAM operations before defining DEBUG 
and/or STAT. DEBUG and STAT are defined by the release defaults. To remove the 
definitions, specify NOTRACE on the call to the NAM5 installation procedure. 
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Network Startup Master File 

The master file that NAM uses to start network processing consists of a set of text 
records that are either parameter records or job skeleton records. The master file 
(NAMSTRT) is in standard NOS text format and is automatically installed on the 
installation user name by SYSGEN. You can modify the file using a text editor or 
through Update directives against the NAM program library. 

A comment can follow the parameters on all statements and directives. 

TITLE Statement 

The TITLE statement designates a parameter record or a job skeleton record. It must 
be the first statement (following the name of the record) of every record in the master 
file. The format follows: 

TITLE(type)title 

Parameter Description 

type Type of record; use PARAM for parameter records and JOB for 

job skeleton records. 

title Text string of 1 through 50 characters used to describe the 

purpose of the record. 

Example: 

TITLE(PARAM) INIT - INITIAL NETWORK INVOCATION 
Parameter Records 

Parameter records contain two kinds of directives that tell NAMI what parameters to 
substitute in job skeletons (PARAM directives) and what jobs to start (JOB directives). 
Each record can consist of a number of lines or directives (up to 80 characters) 
terminated by a zero byte. Refer to the NOS Version 2 Analysis Handbook for a 
description of parameter records available with the released system. 

PARAM Directive 

The PARAM directive is used in the parameter record to define keywords and values 
that are substituted for matching keywords in the job skeleton records. PARAM has the 
following format. 

PARAM(keyword1=va1ue1.keywordn=va1uen) 

Multiple PARAM directives can appear in a parameter record. 

The following rules apply to the PARAM directive: 

• Embedded spaces are ignored. 

• Keywords and values can contain only letters, digits, and asterisks. 

• Keywords and values must be no longer than 7 characters. 
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• If a keyword appears more than once, only the first definition applies. 

Example: 

When the following directive is present, every occurrence of the keyword NCFFN in 
any job skeleton record is replaced by the string NCFFILE. 

PARAM(NCFFN=NCFFILE) NETWORK CONFIGURATION FILE. 

JOB Directive 

The JOB directive specifies the name of a job skeleton record and a code for the name 
of the network product that the job skeleton starts. A JOB directive must appear in 
every parameter record for each Network Host Products program that NAMI should 
start. The JOB directive has the following format: 

JOB(name,t ype[,ssname,at 1,at 2,a 13]) 

Parameter Description 

ati Job attribute. Any of the following are valid: 

ati Description 

DI If specified, the job record is not started at network 

initiation, but it may be started later by using the 
NAMI RS option when the network is operational. 

NS If specified, the job record is routed with the Network 

Supervisor service class (SCL = NS). 

SY If specified, the job record is routed with system origin 

privileges. 

name Name of job skeleton record. 

ssname Subsystem name if program is a subsystem (not required for 

NIP). 

type First two or more characters of an application or program 

name, such as CS, NIP, NS, and so on. (Only the first two 
characters are used.) 

The rules for format of a PARAM directive apply to the JOB directive. 

Example: 

JOB(JOBNIP t NIP) NAM (NIP) JOB. 

Refer to figure 7-8 for an example of a parameter record that contains both PARAM 
directives and JOB directives. 
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INIT TITLE(PARAM) INIT - INITIAL NETWORK INVOCATION. 

. * 

_ * 

.* THIS PARAMETER RECORD 

IS SELECTED WHEN THE NETWORK 

.* IS TO BE STARTED WITH FRESH LOADS OF THE FIRST 

.* LEVEL NPU(S), AND THEIR PREVIOUS CONTENTS 

.* ARE NOT TO BE DUMPED 

* 

. 

.* 1. PURGE ALL PREVIOUS 

• 

NETWORK DUMPS AND TRACES. 

.* 2. LOCAL NPU(S) WILL 

BE STOPPED AND RELOADED 

.* WHEN THE NETWORK IS STARTED. 

* 

.* 3. LOCAL NPU(S) WILL 

NOT BE DUMPED WHEN THEY 

ARE INITIALLY LOADED. 

* 

.* 4. LOCAL NPU(S) WILL 

BE STOPPED IF THE HOST 

.* NETWORK FAILS. 

* 


.* 5. A FAILING NPU WILL 

TRIGGER HOST SUPERVISOR 

.» PROGRAM FIELD LENGTH DUMPS TO BE TAKEN AND 

.* PREVIOUS TRACE FILES TO BE PRESERVED. 

_ * 

^ * 

PARAM(NCFFN=NCFFILE) 

NETWORK CONFIGURATION FILE. 

PARAM(LCFFN=LCFFILE) 

LOCAL CONFIGURATION FILE. 

PARAM(NLFFN=NLFFILE) 

NETWORK LOAD FILE (CCP). 

PARAM(NETUN2=NETADMN) 

CONFIGURATION/LOAD FILE USER NAME. 

PARAM(NIISTP=YES) 

STOP NPU(S) AT HOST INITIALIZATION. 

PARAM(NSFDP=NO) 

INITIALLY LOADED NPU(S) NO DUMP. 

PARAM(NIFSTP=YES) 

STOP NPU(S) AT HOST FAILURE. 

PARAM(NSRT=YES) 

HOST DUMPS/TRACES ON NPU FAILURE. j 

PARAM(ZZINACT=10) 

MINS FOR TERM. INACT SUPV MESSAGE. 

PARAM(ZZMC-500) 

MESSAGE COUNT BEFORE RELEASE TRACE FILE. 

PARAM(ZZRUNCT=3) 

MAX NBR OF PGM RUNS WITH NO OPER ACTION. 

PARAM(ONETAPE=YES) 

* 

COLLECT HOST AND NPU DUMPS TO ONE TAPE. 

* 

JOB(JOBPUR,CO,SY,NS) 

COLLECTOR JOB. 

JOB(JOBNIP.NIP) 

NAM (NIP) JOB. 

JOB(JOBNVF,NV,SY,NS) 

NVF JOB. 

JOB(JOBNS,NS,SY,NS) 

NS JOB. 

JOB{JOBCS,CS,SY,NS) 

CS JOB. 

JOB(JOBTVF,TV,SY,NS) 

• 

TVF JOB. 






Figure 7-8. Example of Parameter Record 




7-128 NOS Version 2 Installation Handbook 


Revision L 






NAM5/NAM5D - Network Access Method Version 1 


Job Skeleton Records 

Each job skeleton record contains the commands and input records required to start 
one network program. The record is in NOS job file format. In any of the commands or 
input record lines, any keyword (1 to 7 letters, digits, or asterisks, delimited by 
separators) may be a substitutable parameter. That is, if any keyword in the job 
skeleton record is identical to a keyword in the parameter record, NAMI substitutes 
the corresponding value from the parameter record for the keyword in the job skeleton. 
If a separator is an underscore, NAMI removes the underscore from the record when it 
makes the replacement. 

In addition to substituting values for keywords defined in the parameter record, 

NAMI also substitutes variables known to it at the time it executes. These variables 
pertain to the startup master file currently in use and to the names of dump and 
trace files which NAMI creates with each new startup of NIP. Certain reserved 
keywords have been defined for use in the job skeleton records wherever one of the 
NAMI variables should be substituted. 


Keyword 

Meaning 

CIN 

Current network invocation number. 

MFN 

Master file name. 

OIN 

Old network invocation number. 

PWM 

Password for master file user name. 

UNM 

Master file user name. 


The following keywords are defined by NAMI and should be used in the job skeleton 
record wherever the dump and trace files are to be referenced. 


Keyword Meaning 


xxDOFIL 

Program dumps. 

xxDIFIL 


xxD2FIL 

Binary dumps of field length. 

xxD3FIL 


xxLOFIL 

Listable output. 

xxSOFIL 

ZZZZZSN. 

xxTOFIL 

ZZZZZDN. 


xx is the first 2 characters of the type from the JOB directive in the parameter record. 

Job skeleton records must be constructed so that the files whose existence is assumed 
by the various programs are present. 

Refer to figure 7-9 for an example of a job skeleton record. 
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JOBNIP TITLE(JOB) JOBNIP - NIP RELEASE DEFAULT JOB SKELETON. 


THIS IS THE STARTUP JOB FOR NIP. 

THE PERMANENT FILES THAT NIP DUMPS AND TRACES ARE WRITTEN TO 
WILL BE COLLECTED BY THE COLLECTOR JOB ALONG WITH THE 
REST OF THE NETWORK TRACES AND DUMPS. 


THE FOLLOWING PARAMETERS MUST BE SET IN THE PARAMETER RECORD. 
NIISTP = STOP NPU(S) AT HOST INITIALIZATION. 

NIFSTP = STOP NPU(S) AT HOST TERMINATION. 

ZZMC = MESSAGE COUNT BEFORE RELEASE OF TRACE FILE. 


PERMANENT FILES FOR RUN DATA ARE DEFINED AT JOB TERMINATION. 


TFN 

LFN 

PFN 

CONTENTS 

OUTPUT 

NIPOUT 

NIDOFIL 

OUTPUT FROM JOB (DMP,DMD,ETC) 

ZZZZZPP 

PIPDMP 

NID1FIL 

PIP DUMPS ON REPRIEVE. 

ZZZZDMB 

NIPDMB 

NID2FIL 

BINARY FIELD LENGTH DUMPS. 

ZZZZTMP 

NIPZTMP 

NID3FIL 

BINARY DUMP FILE. 


NIPLST 

NILOFIL 

JOB DAYFILE. 

ZZZZZDN 

TRCLEV1 


NIP TRACE FILE WRITTEN BY NIP 


TRCLEV2 

ZZNIFIL 

INTERMEDIATE NIP TRACE FILE. 


TRCLEV3 

NITOFIL 

PERMANENT NIP TRACE FILE. 


USER(UNM.PWM) 

NORERUN. 

DISPLAY(DATE) 

DISPLAY(HID) 

DISPLAY(OT) 

DISPLAY(SC) 

RETURN(OUTPUT) 

SETJOB(NAMCIN) 

^ * 

.* PURGE OLD LEVEL-2 TRACE FILES. 
# » 

PURGE(ZZNI_OIN,ZZNI_CIN/NA) 

_ * 

.* PURGE OLD LEVEL-2 TRACE FILES. 
a * 

PURGE(ZZNI OIN,ZZNI CIN/NA) 


Figure 7-9. Example of Job Skeleton Record 


( Continued) 
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(Continued) 


.* START NIP. 

^ * 

RFL(60000) 

NIP(NIN=CIN,ISTP=NIISTP,FSTP=NIFSTP,MC-ZZMC,INACT=ZZINACT) 

* 

.* NIP NORMAL TERMINATION - CHECK FOR ABNORMAL CONDITIONS. 
_ * 

RFL(O) 

SKIP(BAILOUT) 

* 

EXIT. NIP 


* NIP FAILED - SAVE RUN DATA IF REQUIRED. 


DISPLAY(EF) 

IF(EF.NE.SYE.BAILOUT) 

SKIP(SAVFILS) 

.* ENDIF(BAILOUT) 

IF(.NOT.FILE(ZZZZTMP.AS),SAVFILS) 

_ * 

.* NO ABNORMAL CONDITIONS - DO NOT SAVE RUN OATA ON PERMANENT FILES. 
* 

PURGE(NITOFIL,ZZNI_CIN/NA) 

RETURN(OUTPUT) 

WRITER(OUTPUT) 

EXIT. NIP 

.* SAVE RUN DATA IF AVAILABLE. 

* 

ENDIF(SAVFILS) 

* 

IF(FILE(OUTPUT,AS).NOUTPUT) 

ATTACH(NIPOUT=NIDO FIL/NA,M=W) 

IF(.NOT.FILE(NIPOUT,AS)) DEFINE(NIPOUT=NIDOFIL) 

REWIND(OUTPUT) 

SKIPEI(NIPOUT) 

COPYEI(OUTPUT,NIPOUT) 

RETURN (OUTPUT. NIPOUT) 

ENDIF(NOUTPUT) 


Figure 7-9. Example of Job Skeleton Record 
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Continued) _ 

IF(FILE(ZZZZZPP,AS).NOZZZPP) 
ATTACH(PIPDMP=NID1FIL/NA,M=W) 

IF(.NOT.FILE(PIPDMP,AS)) DEFINE(PIPDMP=NID1FIL) 
REWIND(ZZZZZPP) 

SKIPEI(PIPDMP) 

COPYEI(ZZZZZPP,PIPDMP) 

RETURNt ZZZZZPP,PIPDMP) 

ENDIF(NOZZZPP) 

_ * 

IF(FILE(ZZZZDMB,AS),NOZZDMB) 

ATTACH(NIPDMB=NID2FIL/NA,M=W) 

IF(.NOT.FILE(NIPDMB,AS)) DEFINE(NIPDMB=NID2FIL) 

REWINO(ZZZZDMB) 

SKIPEI(NIPDMB) 

COPYEI(ZZZZDMB,NIPDMB) 

RETURN(ZZZZDMB.NIPDMB) 

ENDIF(NOZZDMB) 

IF(FILE(ZZZZTMP.AS).NOZZTMP) 
ATTACH(NIPZTMP=NID3FIL/NA,M=W) 

IF(.NOT.FILE(NIPZTMP,AS)) DEFINE(NIPZTMP=NID3FIL) 

REWIND(ZZZZTMP) 

SKIPEI(NIPZTMP) 

COPYEI(ZZZZTMP,NIPZTMP) 

RETURN(ZZZZTMP,NIPZTMP) 

ENDIF(NOZZTMP) 

* 

ATTACH(TRCLEV2=ZZNI_CIN/NA) 

IF(FILE(TRCLEV2.AS),NTRCLV2) 

SKIPR(TRCLEV2) 

IF(.NOT.FILE(TRCLEV2,EOF)) REWIND(TRCLEV2) 

ELSE(NTRCLV2) 

IF(FILE(ZZZZZDN,AS).NOTRACE) 

E.NDIF(NTRCLV2) 

ATTACH(TRCLEV3=NIT0FIL/NA.M=W) 

IF(.NOT.FILE(TRCLEV3,AS)) DE FINE(TRCLEV3=NIT0FIL) 

SKIPEI(TRCLEV3) 

COPYEI(TRCLEV2,TRCLEV3) 

PURGE(ZZNICIN/NA) 

IF(FILE(ZZZZZDN,AS),NTRCLV1) 

RENAME(TRCLEV1=ZZZZZON) 

REWIND(TRCLEVI) 

IF(ZZMC.NE.O) SKIPR(TRCLEVI) 

COPYBF(TRCLEV1,TRCLEV3) 

BKSP(TRCLEV3) 

SKIPR(TRCLEV3) 

IF(.NOT.FILE(TRCLEV3,EOF)) WRITEF(TRCLEV3) 

ENDIF(NTRCLVI) 






Figure 7-9. Example of Job Skeleton Record 


(Continued) 
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( 'Continued) __ 

RETURN(TRCLEV1,TRCLEV2,TRCLEV3) 

ENDIF(NOTRACE) 

* 

ATTACH(NIPLST=NILOFIL/NA,M=W) 

IF(.NOT.FILE(NIPLST,AS)) DEFINE(NIPLST=NILOFIL) 

SKIPEI(NIPLST) 

NOTE(DFL,NR)/NIDA_CIN 

DAYFILE(DFL) 

PACK(DFL) 

COPYEI(DFL,NIPLST) 

# # 

RETURN(OUTPUT) 

WRITER(OUTPUT) 

EXIT. NIP 
.EOR 


THIS JOB IS SUBMITTED EVERY ZZMC MESSAGES TO PLACE 

THE TRACE INFORMATION FROM THE PROGRAM (LEVEL 1) ONTO 
THE INTERMEDIATE PERMANENT FILE ZZNIFIL (LEVEL 2). 

IF ALL THAT HAPPENS IS THAT THIS JOB IS REPEATEDLY 
SUBMITTED THEN THE TRACE INFORMATION IS KEPT FOR 
ONLY THE LAST 2 TIMES ZZMC MESSAGES. 

THIS CONSTRAINS THE SIZE OF THE TRACE FILE KEPT 
WHEN THE NETWORK IS RUNNING WITHOUT ANY PROBLEMS. 


NIPACIN.T77777. DUMP AIP TRACE TO ZZNIFIL. 
USER(UNM.PWM) 

ATTACH(TRCLEV2=ZZNI_CIN/M=W,NA) 

IF(FILE(TRCLEV2.AS),NTRCLV2) 

SKIPF(TRCLEV2) 

COPYBF(TRCLEV2,TEMP) 

REWIND(TRCLEV2.TEMP) 

COPYBF(TEMP,TRCLEV2) 

ELSE(NTRCLV2) 

DEFINE(TRCLEV2=ZZNI_CIN) 

WRITEF(TRCLEV2) 

ENDIF(NTRCLV2) 


Figure 7-9. Example of Job Skeleton Record 


(Continued) 




Revision L 


Special Product Installation Information 7-133 







NAM5/NAM5D - Network Access Method Version 1 


(Continued) _ 

COPYBF(INPUT,TRCLEV2) ~ 

BKSP(TRCLEV2) 

SKIPR(TRCLEV2) 

IF(.NOT.FILE(TRCLEV2,EOF)) WRITEF(TRCLEV2) 

SETJOB(DC=NO) 

EXIT. NIPA 
. EOR 


-* THIS JOB IS SUBMITTED IN RESPONSE TO A 
*HOP RELEASE DEBUG LOGFILE* COMMAND. 

# * 

■ * THE PURPOSE OF THIS JOB IS TO SAVE ON THE LEVEL 3 PERMANENT 
.* FILE *NIT0FIL* THE PREVIOUS 2 TIMES ZZMC MESSAGES 
.* CURRENTLY IN THE INTERMEDIATE (LEVEL 2) FILE *ZZNIFIL* 

.* BEFORE WRITING THE NEW TRACE DATA (FROM LEVEL 1 FILE) 

.* ON THE INTERMEDIATE (LEVEL 2) FILE. THIS WILL ALLOW THESE 
.* TRACE MESSAGES TO BE COLLECTED AND WRITTEN TO TAPE. 

. # 

* 

NIPB_CIN,T77777. DUMP TO PERMANENT TRACE FILE. 

USER(UNM.PWM) 

ATT ACH(TRCLEV2=ZZNI_CIN/M=W,NA) 

IF(FILE{TRCLEV2,AS).NTRCLV2) 

SKIPR(TRCLEV2) 

IF(.NOT.FILE(TRCLEV2,EOF)) REWIND(TRCLEV2) 

ATTACH(TRCLEV3=NIT0FIL/NA,M=W) 

IF(.NOT.FILE(TRCLEV3,AS)) DE FINE(TRCLEV3=NIT0FIL) 

SKIPEI(TRCLEV3) 

COPYEI(TRCLEV2,TRCLEV3) 

EVICT(TRCLEV2) 

ELSE(NTRCLV2) 

DEFINE(TRCLEV2=ZZNI_CIN) 

ENDIF(NTRCLV2) WRITEF(TRCLEV2) 

COPYBF(INPUT,TRCLEV2) 

BKSP(TRCLEV2) 

SKIPR(TRCLEV2) 

IF(.NOT.FILE(TRCLEV2,EOF)) WRITE F(TRCLEV2) 

SETJOB(DC=NO) 

EXIT. NIPB 


Figure 7-9. Example of Job Skeleton Record 
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Network Host Product (NHP) Program Requirements 

Job skeleton records for the CS, NIP, NS, and NVF jobs must each contain a command 
that calls the program that the job intends to run. These commands have the following 
format: 

prog(keyword1=value1,...,keywordn=valuen) 

Parameter _ Description _ 

prog Program name. 

keywordi = valuei Order independent parameters; optional unless otherwise 

specified. 

The files used by each program are listed following the description of each program 
command. 
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CS - Communications Supervisor 
CS requires the following command: 


C$(MC=mc,NIN=n1n,CP=cputi1,BU=bufuti1) 


Parameter 
BU = bufutil 


CP=cputil 


MC = mc 


NIN = nin 


Description 

Buffer utilization threshold for NPUs, from 0 through 500. The 
default is 0. If available buffers drop below this level, the NPU 
operator is notified. 

CPU utilization threshold for NPUs, from 50 through 100. The 
default is 100. If CPU utilization exceeds this value, the NPU 
operator is alerted. 

Maximum message count; specifies the maximum number of 
messages to be accumulated in the debug log file before 
NETREL is called. No NETREL call is issued if me is 0. The 
default value is 500. 

Network invocation number; 1- to 3-digit decimal number 
assigned by NAMI when the network operation is started. This 
parameter is required. 


CS may not be required in every host of a multihost network. If you do not want CS, 
remove the CS job statements from the network startup master file. 

CS requires the following files: 


Name 

Description 

NCF 

Network configuration file created by NDLP. The permanent file name is 
NCFFILE. NCFFILE must be resident under the user name specified by 
the NETUN2 parameter. The released default for NETUN2 is NETADMN. 

NRFl 

Job record to be copied to the ZZZZZDN file by NETREL. This job record 
determines the disposition of the network trace file when NETREL is 
called on a periodic basis. 

NRF2 

Job record to be copied to the ZZZZZDN file by NETREL. This job record 
determines the disposition of the network trace file when NETREL is 
called as a result of an operator command or NPU failure. 

NOTE 

The default job skeleton for CS creates NRFl and NRF2 from the input records of 
the CS job. 
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NIP - Network Interface Program 
NIP requires the following command. 

NIP(NIN=nin,MC=nic,ISTP=1stp,FSTP=fstp,INACT=i to,N1=n1,N2=n2,N3=n3,MAXFL=maxf1) 

NOTE _ 

If a value less than the minimum is supplied, the minimum value is used. 


Parameter 

FSTP=fstp 


INACT=ito 


ISTP = istp 


MAXFL=maxfl 


Description 


Option to stop all local NPUs upon network host termination. The 
default is YES. 

Value Description 

NO Do not stop local NPUs. 

YES Stop all local NPUs. 

Inactive timeout. Time in minutes for connection to be inactive. 
Default is 10 minutes. After such period NIP will send 
FC/INACT/SM to application. If the value is zero, no 
FC/INACT/SM will be sent. The range is 0 to 99. 

Option to stop all local NPUs during network host initialization. 
The default is NO. 

Value Description 

NO Do not stop local NPUs. 

YES Stop all local NPUs. 

Maximum field length that NIP can reach. The range is from 
61440 to 122880. The default is 98304. 


MC = mc Maximum message count; specifies the maximum number of 

messages to be accumulated in the debug log file before NETREL 
is called. No NETREL call is issued if me is 0. The default value 
is 0. 


NIN = nin Network invocation number; 1- to 3-digit decimal number assigned 

by NAMI when the network operation is started. This parameter 
is required. 

Nl = nl Maximum number of 64-word buffers that can be allocated per 

driver. This value is dependent on the number of batch devices 
and application-to-application connections whose UBZ or DBZ is 
specified to be 640 characters or fewer. The default value is 4. 

The minimum value is 2. 
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Parameter Description 

N2=n2 Maximum number of 128-word buffers that can be allocated per 

driver. This value is dependent on the number of batch devices and 
application-to-application connections whose UBZ or DBZ is 
specified to be 1280 characters or fewer. The default value is 8. 

The minimum value is 4. 

N3 = n3 Maximum number of 192-word buffers that can be allocated per 

driver. This value is dependent on the number of batch devices and 
application-to-application connections whose UBZ or DBZ is 
specified to be 1920 characters or fewer. The default value is 4. 

The minimum value is 2. 

Use the following formula to determine a value for MAXFL for a particular 

configuration. (Round MAXFL to the nearest multiple of 64.) 

MAXFL = 11096 + 700h + 6560a + 30(c+d) + 30e + m + 20 (kiwi + ... + knwn) 

+ 22y + 13z + 78b1 + 142b2 + 206b3 

Variable Description 

a Maximum number of applications with up to eight application-to- 

application connections. 

bi Maximum number of 64-word PRU buffers (N1 times the number of 

drivers) that can be allocated to NAM. 

b2 Maximum number of 128-word PRU buffers (N2 times the number of 

drivers) that can be allocated to NAM. 

b3 Maximum number of 192-word PRU buffers (N3 times the number of 

drivers) that can be allocated to NAM. 


c 

d 

e 


h 


Maximum number 

Maximum number 

Maximum number 
time. 

Maximum number 


of hosts in network, 
of NPU nodes in network. 

of applications to be connected at any one point in 
of host nodes. 
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Variable Description 

kiwi Words per terminal. This value must be determined for each of the 

terminals configured in the local configuration file. It depends upon both 
the application block limit and the network block limit defined for each 
terminal and the type of terminal, as follows: 

Variable Description _ 

ki Application block limit (ABL) and downline block limit (DBL). 

Use one of the following values: 

Value 1 

ABL ^ 2 and DBL < 2. 

Value ABL - 1 

ABL > 2 and DBL ^ 2. 

Value DBL - 1 

ABL ^ 2 and DBL > 2. 

Value ABL + DBL - 2 
ABL > 2 and DBL > 2. 

wi Number of interactive terminals with the specified block limit, 

m Maximum node number. 

y Number of connected batch terminal devices, 

z Number of connected interactive devices. 

PRU buffers are dynamically allocated as necessary. The maximum number of buffers 
specified should be enough to handle the heaviest load. Specifying a large value will 
have no affect on network performance or resources unless there is heavy PRU traffic. 

The network configuration file allows you to select the number of PRUs to be 
transferred on connections with batch devices between the PIP and the NPU. 

Since performance is related to available buffers, correct PRU buffer allocation is 
important. In general, a PRU buffer can support from four through six active data 
streams at 9600 baud. The suggested configuration is two 64-word PRU buffers 
(Nl = 2), two 128-word PRU buffers (N2=2), and two 192-word PRU buffers (N3 = 2) if 
PIP supports the PRU data transfers on all three PRU buffer sizes. 

NOTE _ 

Leave PIP and its associated overlays on disk. Moving these overlays to central 
memory does not increase performance, since PIP copies its transient overlays to 
NAM’s field length during its initialization. 
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NS - Network Supervisor 

NS requires the following command: 

NS(NIN=n1n,FDP=fdp,RT=rt,MC=mc,NDFCT=option) 

Parameter _ Description _ 

FDP=fdp Forced dump option. The default is NO. 

Value _ Description _ 

NO NPUs are not dumped in the first 10 minutes of 

program execution except for the initial load. 

YES After the first initial load and in the absence of other 

NPU dumping conditions, NPUs are dumped in the 
first 10 minutes of program execution before loading 
takes place. 

MC = mc Maximum message count; specifies the maximum number of 

messages to be accumulated in the debug log file before NETREL 
is called. No NETREL call is issued if me is 0. The default value 
is 500. 

NDFCT=option File category of NPU dump files. The following options can be 
specified. 

Option Description 

P Private file. 

PU Public file. 

S Semiprivate file. 

NIN = nin Network invocation number; 1- to 3-digit decimal number assigned 

to NAMI when the network operation is started. This parameter 
is required. 

RT=rt Release trace file option. The default is YES. 

Value Description 

NO Trace files are not requested to be released. 

YES NAM requests NS programs CS and NVF to release 

their trace files whenever NS dumps an NPU. 

NS may not be required to run in every host of a multihost network. If you do not 
want NS, remove the NS job statements from the network startup master file. 
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NS requires the following files: 


Name 

Description 

NLF 

Network load file created by LFG in the CCPLOAD procedure 
(refer to the NOS Version 2 Analysis Handbook for a description 
of LFG). The permanent file name is NLFFILE. NLFFILE must be 
resident under the user name specified by the NETUN2 parameter. 
The released default for NETUN2 is NETADMN. 

NCF, NRF1, 
and NRF2 

Described under CS, earlier in this section. 

NVF - Network Validation Facility 

NVF requires the following command: 

NVF(AL=ar1,LL= 

lrl,MC=mc,NIN=n1n) 

Parameter 

Description 

AL = arl 

Application retry limit. This parameter specifies the maximum 
number of invalid application connection request attempts an 
application is allowed before NVF considers the application to be 
breaching security and aborts the application. The value can 
range from 1 through 4. The default is 1. 

1 —< 

II 

Login retry limit. This parameter specifies the maximum number 
of invalid login attempts a user is allowed before NVF considers 
the user to be breaching security and terminates the connection. 
The value can range from 1 through 4. The default is 4. 

MC = mc 

Maximum message count; specifies the maximum number of 
messages to be accumulated in the debug log file before NETREL 
is called. No NETREL call is issued if me is 0. The default value 
is 500. 

NIN=nin 

Network invocation number; 1- to 3-digit decimal number assigned 
by NAMI when the network operation is started. This parameter 
is required. 

NVF requires the following files: 

Name 

Description 

LCF 

The local configuration file created by NDLP. The permanent file 
name is LCFFILE. LCFFILE must be resident under the user 
name specified by the NETUN2 parameter. The released default 
for NETUN2 is NETADMN. 

NRF1 and 

NRF2 

Described under CS, earlier in this section. 
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NIP5870 - 5870 Printer 

This section describes the installation procedure messages for the 5870 printer. 

Installation Procedure Messages 

The DECKOPL installation procedure for NIP5870 contains a loader error. The 
following messages appear in the load map: 

*»***.**, ERROR SUMMARY 

NE4103///DUPLICATE PROGRAM NAME FROM FILE 

PROGRAM SKIPPED - HSTCOPY 

LAST FILE ACCESSED- HSTBIN 

The following message appears in the dayfile: 

NON-FATAL LOADER ERRORS - SEE MAP 

This condition is non-fatal and does not affect the generated binaries. The frequency of 
occurrence is relative to this product as released. Any local code may change the 
frequency. 
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NOS and NOS2B - Network Operating System 

The NOS procedure assembles all COMPASS routines; the NOS2B procedure assembles 

the FORTRAN and SYMPL routines. 

This section describes the following: 

• Configuration Information 

• CALLxxx Decks 

• Installation Parameters 

• 819 PPU Driver Installation 

Configuration Information 

NOS is configured by making entries into several text records, known as deadstart 

decks, which reside on the deadstart tape. These decks are described below: 

• CMRDECK (Central Memory Resident Deck). The entries in this deck describe 
information kept in central memory during system operation. For example, entries 
determine how NOS and NOS/VE will share physical mainframe memory, how 
much table space should be set aside for executing jobs and for input and output 
queue files, and the name of the system to be displayed to users on their login 
banner. Entries in the CMRDECK determine which EQPDECK, IPRDECK, and 
LIBDECK will be used. CMRDECK entries must be made in order to install the 
system. 

• EQPDECK (Equipment Deck). The entries in this deck describe the hardware 
peripherals connected to your mainframe. Entries specify how disks, tapes, 
printers, network hardware, and other equipment are connected to the computer. 
Additional entries are used to specify how the system is to use the hardware. For 
example, you specify which disks will hold the NOS system file, user permanent 
files, temporary files, etc. Additional entries determine if a portion of the physical 
memory is to be used for Unified Extended Memory (UEM) and how UEM is to 
be allocated. For other peripherals, such as network hardware, software node 
numbers must be assigned which relate a physical piece of hardware to an entry 
in a software configuration file. EQPDECK entries must be made to install the 
system. 

• APRDECK (Auxiliary Mass Storage Parameter Deck). The entries in this deck 
identify locations on mass storage (disks) which are unusable or flawed. Normally, 
no entries are required in this deck. 

• IPRDECK (Installation Parameter Deck). The entries in this deck specify the 
default mode of system operation. For example, entries determine what the 
relative priorities of the various job classes on the system are, what the default 
tape density is, and what subsystems should be initiated automatically when the 
system is deadstarted. Normally, no IPRDECK entries are needed unless 
subsystem initiation must be altered. 

• LIBDECK (Library Edit Deck). The entries in this deck specify the attributes of 
the programs on the deadstart tape. Primarily, the entries specify where the 
programs should be located; on disk, in central memory, or in UEM. Normally, 
this deck does not need to be altered. 
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CMRDECKs, EQPDECKs, APRDECKs, IPRDECKs and LIBDECKs are described in the 
Deadstart Decks section of the NOS Version 2 Analysis Handbook. 

The deadstart tape can contain many different combinations of deadstart decks which 
makes it possible to have several different configurations for the same mainframe and 
to configure multiple mainframes on one tape. The released deadstart tape contains 
deadstart decks for installing on many different mainframes and hardware 
configurations. Tables 2-3, 2-4, and 2-5 contain an index of the decks. 


CALLxxx Decks 

These decks are tools for conveniently generating listings of various system common 
decks, for example: 

CALLCPU assembles all common decks named COMCxxx. 

CALLDIS assembles all common decks named COMDxxx. 

CALLINT assembles all common decks named COMIxxx. 

CALLPPU assembles all common decks named COMPxxx. 

CALLSYS assembles all common decks named COMSxxx. 

CALLTAB assembles all common decks named COMTxxx. 

Since these decks may assemble many common decks that were never intended to be 
assembled together (at least in a real program), assembly errors may result. These 
errors are normal and have always existed in these decks. The number of errors may 
change from release to release. The following is an example of a COMPASS command 
to assemble all six decks: 

MODIFY,A,P=op1,LO=E,Z./*EDIT CALLCPU.CALLINT 
COMPASS,I,S=NOSTEXT,S=CETEXT,0=er r1ist,L=1iSt. 

Replace opl with the name of the composite OPL, replace errlist with the name of the 
file to contain the assembly errors (which may be ignored), and replace list with the 
name of the file that will contain the desired common decks. 


7-144 NOS Version 2 Installation Handbook 


Revision L 



NOS and NOS2B - Network Operating System 


Installation Parameters 

You can modify installation parameters for the operating system by following these 
steps: 

• Execute the MODOPL procedure, incorporating any corrective code (corrective code 
can change the deck line numbers). 

• Get a listing of the deck that contains the parameter you want to change. From 
the listing, get information such as the line numbers of the installation 
parameters you need to change. 

• Put the NOS installation procedure parameter changes on a USER file and again 
execute the MODOPL procedure. 

If you change any of the installation parameters in a NOS deck, reassemble all 
routines that use that deck. Use the KRONREF command to determine which routines 
use the NOS deck. 

Refer to table 7-8 for brief descriptions of the NOS common decks that contain 
installation parameters. 
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Table 7-8. NOS Common Decks 


Common Deck 
Name 

A Deck That Calls 
the Common Deck 

Description 

COMSACC 

CALLSYS 

User validation limits. 

COMSBIO 

CALLSYS 

Central site batch I/O parameters. 

COMSIOQ 

CALLSYS 

Dayfile/QPROTECT equivalences. 

COMSJIO 

CALLSYS 

Devices to which users route files. 

COMSLSD 

CALLSYS 

Search for label sector of a mass storage 
device. 

COMSMLS 

CALLSYS 

Specifies micros that define multilevel 
security access levels and access 
categories. 

COMSMMF 

CALLSYS 

Multimainframe parameters. 

COMSMSC 

CALLSYS 

Miscellaneous parameters for the 
operating system. 

COMSMTX 

CALLSYS 

Magnetic tape executive routine and 
magnetic tape processing routine 
parameters. 

COMSPFM 

CALLSYS 

Permanent file symbols and locations 
and formats of call blocks, catalog, and 
permit entries. 

COMSPRO 

CALLSYS 

PROFILa parameters. 

COMSREM 

CALLSYS 

Interactive Facility (IAF) parameters. 

COMSRSX 

CALLSYS 

Job resource executive parameters. 

COMSSCD 

CALLSYS 

Service class definitions. 

COMSSFS 

CALLSYS 

Field length limit for execution of 
MODVAL and PROFILE commands. 

COMSSRU 

CALLSYS 

Parameters used in SRU calculations. 

COMSSSJ 

CALLSYS 

Special system job parameters. 

COMSVED 

CALLSYS 

Virtual environment definitions. 

COMTNAP 

CALLTAB 

Valid NAM application parameters. 

PPCOM 

PPTEXT 

Maximum number of local files, number 
of words in a block of ECS, maximum 
number of EST entries, length of 

L-display input and output buffers, and 
number of mass storage devices. 


7-146 NOS Version 2 Installation Handbook 


Revision L 



NOS and NOS2B - Network Operating System 


COMSACC Parameters 


COMSACC contains a general description of the user validation file. Assemble 
CALLSYS to obtain a listing of COMSACC. 


Parameter 

Default 

Description 

APFN 

VALIDUS 

Micro definition that specifies the name of the file 
containing the user names that validate user access to the 
operating system. Refer to the NOS Version 2 
Administration Handbook for further information on 
VALIDUS. 

AUFN 

VALINDS 

Micro definition that specifies the name of the available 
user indexes file. Refer to the NOS Version 2 
Administration Handbook for further information on 
VALINDS. 

SSPMN 

70s 

Minimum security system prolog index. 

The NOS Version 2 Administration Handbook describes the use of the following 
COMSACC user control parameters. 

Parameter 

Default 

Description 

APXL 

77778 

User password expiration term limit in days, from 1 
through 77778. This value establishes the upper limit on 
the expiration term that the user can specify with the XT 
parameter on the PASSWOR command (refer to the NOS 
Version 2 Reference Set, Volume 3). 

APXT 

77778 

Default user password expiration term in days, from 1 
through 77778. This value is assumed when MODVAL sets 
a password for a new user name. APXT must be less 
than or equal to APXL. A value of 7777s indicates the 
password cannot expire. 

KCCI 

100B 

Default limit for commands processed; the maximum value 
is 1768. 

KCMI 

37B 

Default limit for central memory field length/1008; the 
maximum value is 378. 

KCPI 

0 

Default limit for cards punched from a file; the maximum 
value is 76s. 

KDFI 

100B 

Default limit for dayflle messages written; the maximum 
value is 1768. 

KDTI 

0 

Default limit for the number of detached jobs; the 
maximum value is 37s. 

KECI 

0 

Default limit for extended memory field length/10008; the 
maximum value is 176s. 

KLPI 

1000B 

Default limit for lines printed from a file; the maximum 
value is 3776s. 


Revision L 


Special Product Installation Information 7-147 



NOS and NOS2B - Network Operating System 


Parameter 

Default 

Description 

KMSI 

1000B 

Default limit for additionally allocated mass storage 

PRUs; the maximum value is 7776s. 

KPTI 

1000B 

Default limit for the number of units plotted; the 
maximum value is 76000s. 

KSLI 

10B 

Default limit for SRU accumulation; the maximum value 
is 768. 

KTLI 

10B 

Value used in calculating the default time limit; the 
maximum value is 176s. For details of the algorithm used 
in the calculation, refer to the NOS Version 2 
Administration Handbook. 

COMSBIO Parameters 


COMSBIO contains the following parameters, which are used for control of BIO 
functions. Assemble CALLSYS to obtain a listing of COMSBIO. 

Parameter 

Default 

Description 

PL6L 

64 

Number of lines of print a user is charged for each page 
of output printed by BIO at six lines per inch. 

PL8L 

85 

Number of lines of print a user is charged for each page 
of output printed by BIO at eight lines per inch. 

COMSIOQ Parameters 

- 

COMSIOQ contains the following parameter, which is used for control of terminated 
dayfiles. Assemble CALLSYS to obtain a listing of COMSIOQ. 

Parameter 

Default 

Description 

USRN 

null 

Micro definition that specifies the user name to which 


terminated dayfiles should be permitted. 
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COMSJIO Parameters 

COMSJIO contains the following parameters, which define the devices to which the site 
allows users to route files. Two-character disposition codes, corresponding to the device 
codes defined for the ROUTE command, followed by a $ identify the supported devices. 
Assemble CALLSYS to obtain a listing of COMSJIO. 


Parameter 

Default 

Description 

LR$ 

Defined 

Any 580-12 printer. 

LS$ 

Defined 

Any 580-16 printer. 

LT$ 

Defined 

Any 580-20 printer. 

LX$ 

Defined 

Any 5870 nonimpact printer. 

LY$ 

Defined 

Any 5970 nonimpact printer. 

P8$ 

Defined 

Punch 80-column binary. 

PB$ 

Defined 

Punch system binary. 

PH$ 

Defined 

Punch coded. 

PL$ 

Defined 

Plotter. 

PR$ 

Defined 

Any line printer. 

PU$ 

Defined 

Punch coded. 

SB$ 

Defined 

Punch system binary. 

WT$ 

Defined 

Wait Queue. 

COMSLSD Parameters 


COMSLSD contains the following parameter, which references information maintained 
in the label sector of a mass storage device. Assemble CALLSYS to obtain a listing of 
COMSLSD. 

Parameter 

Default 

Description 

LTKL 

20B 

If you did not initialize a mass storage device during 
deadstart (using the INITIALIZE entry described in the 
NOS Version 2 Analysis Handbook), the system searches 
the device for a label that might be in track 0. 


This parameter specifies the number of tracks the system 
searches before determining that the device has a bad 
label or no label. When it reaches that track number, it 
stops searching for a label. If the device is a system 
device, the system writes a new label; if it is not a 
system device, the error codes LE (label error) and U 
(unavailable) status are entered in the mass storage table 
(MST), and the device must be initialized after deadstart. 
MST is described in the NOS Version 2 Analysis 
Handbook. 
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COMSMLS Parameters 


COMSMLS contains micros that define security access levels and access categories. 
Redefining any of the access level or access category micros requires reassembly of all 
programs that reference them. The site security administrator supplies any changes to 
be made to these micros. Assemble CALLSYS to obtain a listing of COMSMLS. 


Parameter Default 


ALMO 

LVLO 

through 

through 

ALM7 

LVL7 

ACM00 

CAT00 

through 

through 

ACM31 

CAT31 


Description 

Micro definitions that specify the names of access level 0 
through access level 7. 


Micro definitions that specify the names of access category 
00 through access category 31. 


COMSMMF Parameters 

COMSMMF contains parameters that define the multimainframe tables that reside on 
the link device. Assemble CALLSYS to obtain a listing of COMSMMF. 

Parameter Default Description 

MXMF 4 Maximum number of mainframes in a multimainframe 

configuration. Two to seven mainframes are allowed. 
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COMSMSC Parameters 

COMSMSC contains the following miscellaneous parameters, which are used by the 
operating system. Assemble CALLSYS to obtain a listing of COMSMSC. 


Parameter 

Default 

Description 

AFDL 

20000B 

Account file threshold size in PRUs. 2 

BLTL 

1000B 

Binary maintenance log threshold size in PRUs. 2 

DFDL 

20000B 

Dayfile threshold size in PRUs. 2 

ELDL 

1000B 

ty 

Error log threshold size in PRUs. 

HRTL 

2 

Maximum number of times + 1 that a job will be rerun 
due to a hardware error. 

MSER 

2 

Maximum number of times + 1 that a job will be rerun 
due to a software error. 

MXSY 

5 

Maximum number of devices that can be defined as 
system devices during deadstart. 

SYSCHG 

SYSTEM 

Specifies the system charge number for jobs initiated 
under DSD. 

UPTL 

10B 

Maximum number of uncorrected processor errors that can 
occur per hour before the operator is notified. 


2. When entries in any of these flies reach the threshold, the A,OPERATOR flashing message appears on the 
console screen (refer to the NOS Version 2 Operations Handbook). 
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COMSMTX Parameters 


COMSMTX contains the following parameters, which are used by the magnetic tape 
executive routine and by related magnetic tape processing routines. Assemble CALLSYS 
to obtain a listing of COMSMTX. 


Parameter 

Default 

MUNIT 

16D 

NTIM 

300 

POGH 

0 


POLM 0 


Description 

Maximum number of tape units defined per mainframe. 

Delay time in seconds (decimal) before reissuing the 
CHECK, E,P DISPLAY message at MAGNET’S control 
point when entries exist in MAGNET’S preview buffers. 

Flag indicating whether the system allows 
hardware-detected correctable errors when writing on 
6250-cpi group-encoded (GE) tapes. The user can override 
the installation setting of POGH with parameters on the 
tape assignment command (refer to the NOS Version 2 
Reference Set, Volume 3). 

If POGH is 0, the tape subsystem performs write error 
correction according to industry standard group-coded 
recording (GCR) techniques. Control Data recommends 
this setting because it provides efficient throughput, error 
recovery, and tape use when writing GE tapes on media 
suitable for use at 1600 cpi or 6250 cpi. 

If POGH is 1, hardware GCR error correction is disabled. 
Control Data recommends this option only for special 
archiving and diagnostic applications. Successful use 
requires higher-than-normal quality tape and special drive 
adjustments. Use in a normal environment generally 
results in increased error rates, decreased throughput, and 
decreased tape capacity. Use only tape that is suitable for 
recording at 6250 cpi when this setting of POGH is in 
effect. Because use of the disabled GCR error correction 
mode (also known as perfect write) may necessitate 
additional maintenance activities, consult site maintenance 
personnel before making this the default mode of 
operation. 

Flag indicating whether tape detailed status error 
messages are issued to the job dayfile. If POLM is 0, the 
system does not issue these messages to the job dayfile. If 
POLM is 1, the system issues the message to the dayfile 
for both the first and the last attempt to read a bad tape 
block. The user can override the installation setting of 
POLM with parameters on the tape assignment command 
(refer to the NOS Version 2 Reference Set, Volume 3). 

The system issues all tape error messages to the error log 
regardless of the setting of POLM. 
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Parameter 

PONR 


Default Description 

0 Flag indicating whether the system automatically assigns 

a mounted tape that cannot be verified as the tape being 

requested. This pertains only to the following situations: 

1. Mounting a second or later reel in a multi-reel 
unlabeled tape request. 

2. Mounting a second or later reel in a multi-reel labeled 
tape request where no VSN was specified on the 
request 

3. Mounting a first reel in an unlabeled tape request 
after a ring conflict has occurred on that reel. 

If PONR is 0, the system does the following: 

• In situations 1 and 2, the E, P display issues the 
message MOUNT to inform the operator to mount (or 
if the tape is already mounted on another drive, to 
assign via the VSN command) the next tape. Any tape 
subsequently mounted or assigned is then 
automatically accepted. 

• In situation 3, any tape subsequently mounted with 
the correct ring status is automatically accepted. 

If PONR is 1, the system does the following: 

• In situations 1 and 2, the E, P display issues the 
message CHECK AND MOUNT to inform the operator 
to visually verify that the next tape to be mounted or 
assigned is in fact the tape being requested. The 
system then gives the operator the option of either 
dropping the job (if the correct tape could not be 
found) or entering the DSD command, NEXTREEL,est., 
to inform the system that the operator has found the 
correct tape. Any tape subsequently mounted or 
assigned is then automatically accepted. If the 
NEXTREEL command is not entered before the next 
tape is mounted or assigned, the system rejects and 
unloads the tape and redisplays the CHECK AND 
MOUNT message. 
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Parameter Default 

PONR 

(Continued) 


ZFAM A null 

micro 


Description 

• In situation 3, the operator must enter the 

NEXTREEL command before remounting the tape with 
the correct ring status. Failure to do so causes the 
system to reject and unload the tape and display the 
CHECK AND MOUNT message. 

Enables conversion of binary zero family names to 
nonzero family names. ZFAM allows users to continue to 
access labeled tapes that are restricted to owner access 
(file accessibility field in HDR1 label is A) and were built 
under the binary zero family. If ZFAM is a null micro, 
the system default family name is substituted for the 
binary zero family name; otherwise, ZFAM specifies the 
name to be substituted. 
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COMSPFM Parameters 

COMSPFM contains the following parameters, which are used for permanent file 
symbols and locations, formats of call blocks, and catalog and permit entries. Assemble 
CALLSYS to obtain a listing of COMSPFM. 

Parameter Default Description 

ACDF ACNO Alternate user CATLIST permission (AC) default 

specification for new files; ACDF can be set to the 
following values: 

Value Description 

ACNO Newly created files are not CATLISTable. 

ACYS Newly created files are CATLISTable. 

ACEX ACNO Alternate user CATLIST permission (AC) default 

specification for existing files (files created prior to NOS 
level 617); ACEX can be set to the following symbolic 
values: 

Value Description 

ACNO Existing files are not CATLISTable. 

ACYS Existing files are CATLISTable. 

APLO 1 Auxiliary pack load option. This parameter controls 

whether or not a user can request an auxiliary pack to be 
loaded via an MFLINK request. When APLO equals 0, 
MFLINK requests to auxiliary packs not currently 
mounted are rejected with the message DEVICE 
UNAVAILABLE. When APLO is equated to a nonzero 
value, such MFLINK requests may roll out while waiting 
for the pack to be mounted (provided the user specified 
the NA or WB parameter). Since there is no global 
resource executive in an LCN environment, a potential for 
a temporary deadlock exists in the latter instance. If this 
happens, the RHF applications involved are timed-out and 
aborted. 


BRDE BRAL Backup requirement (BR) default specifications; can be set 

to the following symbolic values. 

Value Description 

BRAL Backup always required. 

BRMD Media-dependent backup for systems with a 

supplemental mass storage facility. 

BRNO No backup required. 

GRMX Maximum BR value. 
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Parameter 

DFPT 


FPXL 


FPXT 


MNHS 


Default Description 

Dll Equipment type. When accessing a removable auxiliary 

device with a permanent file command, the permanent file 
manager checks that the equipment type and pack name 
of the device match the equipment type (R parameter) and 
pack name on the command. If R is not specified, the 
system uses the equipment type specified by DFPT. If the 
default is used for another equipment type, the error 
message INCORRECT DEVICE REQUEST occurs. 

Changes in the default may be made through the DFPT 
IPRDECK entry. 

77778 Permanent file password or permission term limit in days, 

from 1 through 77778. This value establishes the upper 
limit on the expiration term that a user can specify on a 
permanent file request. Changes to this parameter should 
be supplied by the site security administrator. 

77778 Default permanent file password or permission term in 

days, from 1 through 7777s. This value is assumed when 
the user does not specify an expiration term parameter on 
a permanent file request. FPXT must be less than or 
equal to FPXL. A value of 7777s indicates the password 
or permission cannot expire. Changes to this parameter 
should be supplied by the site security administrator. 

5 Minimum size hole, in sectors, that the permanent file 

manager (PFM) creates in the indirect access file chain 
when using an existing hole. If, in searching for a hole in 
which to save an indirect access file, PFM finds that 
using an existing hole creates a new hole containing 
fewer sectors than MNHS, then PFM allocates space at 
the end of the indirect access chain. If a delink operation 
creates a hole smaller than MNHS, PFM delinks one less 
track to ensure minimum size for the hole. Purging a file 
whose total length is less than MNHS creates a hole 
smaller than MNHS. 

If a value for MNHS is smaller than the average length 
of the indirect access files on the system, it results in 
holes that may be unusable. If the value is larger than 
the average file length, it results in holes which are not 
used for a period of time. For efficient use of holes, the 
value for MNHS should be close to the average length of 
the indirect access files on the system. 

The minimum value for MNHS is 3; the maximum value 
is 77778. 
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Parameter Default 
PGUI 3000008 


PMLM 

62io 

RSDE 

RSNP 


Description 

PFDUMP (refer to the NOS Version 2 Analysis 
Handbook) purge limit user index. When PFDUMP is 
used with the purge option, selected files under user 
indexes greater than PGUI are dumped, but not purged. If 
PGUI is changed, PFDUMP must be reassembled. 

Number of explicit permissions allowed per file, 1 through 
4095. If PMLM is changed, PFM must be reassembled. 


Preferred residence (PR) default specification; can be set 
to the following symbolic values. 


Value 

Description 

RSDS 

Disk residence preferred. 

RSLK 

Locked to disk. 

RSMS 

Mass storage facility residence preferred. 

RSMX 

Maximum PR value. 

RSNP 

No preferred residence. 


For individual users, each of four permanent file access limits is established through 
MODVAL (refer to the NOS Version 2 Administration Handbook) by specifying a 
range index from 0 through 7. Each range index corresponds to an upper limit 
specified by one of the following installation parameters. The last character of the 
installation parameter indicates the range index being defined. Table 7-9 summarizes 
the released values for each parameter. Setting a parameter to 0 indicates unlimited 
access. 


Parameter Description 

CSRNGn Upper limit of range n for cumulative size of indirect access files, 
specified in PRUs; must not exceed 7777778- 

DSRNGn Upper limit of range n for size of individual direct access files, 
specified in PRUs; must not exceed 7777778. 

FSRNGn Upper limit of range n for size of individual indirect access files, 
specified in PRUs; must not exceed 77777s. 


NFRNGn Upper limit of range n for file count; must not exceed 77777s. 


Table 7-9. Released Values of Permanent File Limit Ranges 


Parameter 

n = l 1 

n = 2 1 

n = 3 1 

n = 4 1 

n = 5 1 

n = 6 1 

n = 7* 

CSRNGn 

1000 

2000 

5000 

10000 

50000 

100000 

0 

DSRNGn 

1000 

2000 

5000 

10000 

50000 

100000 

0 

FSRNGn 

10 

30 

50 

100 

150 

300 

0 

NFRNGn 

10 

20 

30 

40 

50 

100 

0 


1. All values are specified in octal; 0 indicates unlimited access. 
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COMSPRO Parameters 


The following COMSPRO parameters contain a general description of the PROFILa file. 
Assemble CALLSYS to obtain a listing of COMSPRO. 


Parameter 

Default 

Description 

PPFN 

PROFILC 

Micro definition specifying the PROFILE routine’s 
database file name (refer to the NOS Version 2 
Administration Handbook). 

PPWD 

SECURUS 

Micro definition specifying the PROFILE routine’s 
database file password. 

PUSN 

SYSTEMX 

Micro definition specifying the catalog location of the 
PROFILE routine’s database. 

COMSREM Parameters 


COMSREM contains the following parameters, which are used by the Interactive 

Facility (IAF) executive. Assemble CALLSYS to obtain a listing of COMSREM. 

Parameter 

Default 

Description 

NMFL 

60000B 

Defines the size of NAM’s field length as used by the 
algorithm in COMPCMX. This calculation determines the 
field length available for an interactive job. This value 
should be equal to the value of MAXFL, which defines 
the maximum field length that NAM can attain. MAXFL 
is a parameter on the NIP command. 

TAPC 

20B 

Number of pots of typed ahead input to be stored in IAF’s 
FL for each user. 

UTIS 

10D 

Value used in calculating the default CPU time limit in 
seconds for any particular terminal job’s activity, if it is 
. not specified with the SETTL command (refer to the NOS 
Version 2 Reference Set, Volume 3). For details of the 
algorithm used in calculating the default time limit, refer 
to the NOS Version 2 Administration Handbook. 

VDSI 

VDTI 

100B 

100B 

Default system resource unit (SRU) and time limit 
increment values for the S.nnnnn and T.nnnnn interactive 
commands. 

VNCP 

40B 

Number of pots of output to be stored in IAF’s FL for 
each user. 

VXLL 

2500D 

Maximum number of characters in a logical input line. 

VXPH 

2500D 

Determines the physical line length that IAF accepts. IAF 
uses VXPH to calculate a buffer length. 
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COMSRSX Parameters 

COMSRSX contains the following parameters, which are used by the resource 
executive. Assemble CALLSYS to obtain a listing of COMSRSX. The released values 
assume the default job scheduler cycle of 1 second. 


Default Value 
Parameter in Minutes 

MTMS 2 


MTOV 8 


RFTL 10 


Description 

When one of the following situations prevents 
immediate assignment of the tape, MTMS specifies 
the length of time that a job requesting a tape is 
rolled out before retrying the assignment. 

• The job requests a tape with a VSN that is not 
currently available. 

• The job requests a 9-track tape that is mounted 
without a write ring, the job requests the wrong 
tape density, and the tape hardware detects that 
the density of the tape is incompatible with the 
unit on which it is mounted (800-cpi tape on a 
1600/6250-cpi drive or 6250-cpi tape on an 
800/1600-cpi drive). 

Length of time that a job that has had a request 
for a magnetic tape denied because of 
overcommitment deadlocks is rolled out before 
retrying the assignment. 

Length of time that a job requesting a resource is 
rolled out before retrying the request when a track 
limit occurs on the resource demand or VSN files. 


RPMS 4 

RPOV 8 


SUBM 10 


Length of time that a job. waiting for an auxiliary 
device is rolled out before retrying assignment. 

Length of time that a job that has had a request 
for an auxiliary device denied because of 
overcommitment deadlocks is rolled out before 
retrying assignment. 

If MAGNET is not active, length of time that a 
noninteractive service class job calling RESEX is 
rolled out before retrying assignment. 
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COMSSCD Parameters 

COMSSCD contains the definitions of the service classes used by NOS. Assemble 
CALLSYS to obtain a listing of COMSSCD. By default, four installation service classes 
are defined: 10, II, 12, and 13. To define additional installation service classes, add 
CLASS macro calls similar to those already present. You can also change the 
attributes of the defined installation service classes (those that are parameters on the 
CLASS macro). However, if you make any changes, reassemble all the decks that call 
COMSSCD. 

COMSSFS Parameters 

COMSSFS parameters are used by the MODVAL and PROFILE commands. Assemble 
CALLSYS to get a listing of COMSSFS. 

Parameter Default Description 

FLLM 500008 Specifies the field length limit for the execution of the 

MODVAL and PROFILE commands. If the execution of a 
MODVAL or PROFILE command requires more than the 
specified field length, disk storage is used. Accessing disk 
storage is more time-consuming than accessing central 
memory and degrades performance. 

COMSSRU Parameters 

COMSSRU contains the parameters used in SRU calculations. Assemble CALLSYS to 
obtain a listing of COMSSRU. Refer to COMSSRU in the NOS Version 2 
Administration Handbook. 

COMSSSJ Parameters 

COMSSSJ contains the following parameters, which are used by special system jobs. 
Assemble CALLSYS to obtain a listing of COMSSSJ. The released values assume the 
default job scheduler cycle of 1 second. 

Parameter Default Description 

ART 4 minutes Length of time that a job is rolled out while waiting for a 

direct access file to become available before trying to 
access it again. This value specifies the default for the 
WB parameter on the ATTACH command. 

FRT 15 seconds Length of time that a special system job is rolled out 

when a fast-attach file is busy. 
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COMSVED Parameters 

COMSVED defines two assembly constants to determine how many pool and driver PPs 
to reserve for NOS use in a dual state environment. Assemble CALLSYS to obtain a 
listing of COMSVED. 

Parameter Default Description 

MINDP MINP/2 Defines the number of driver PPs reserved for NOS on a 

CYBER 180-810/830 with 20 PPs. 

MINP 4 Defines the number of pool PPs reserved for NOS. 

The number of PPs reserved by MINP and MINDP is in addition to dedicated PPs 
(such as MTR and DSD) and PP programs which occupy a PP for a relatively long 
time (such as 1CD). Note that this code is executed by VER (assembled in the DUAL 
installation procedure). 

COMTNAP Parameters 

COMTNAP defines a table that maps valid NAM application names to the bit position 
of the access word that must be set to allow use of one or more network applications 
(refer to the description of MODVAL in the NOS Version 2 Administration Handbook). 
Assemble CALLTAB to obtain a listing of COMTNAP. This common deck does not 
contain any executable code. Each table entry has the following format. 


59 17 11 0 


application name (6-bit display code, 

reserved 

application validation 

left-justified, blank-filled) 

word bit position 


Bits 17 through 12 of each entry are reserved for the program that uses COMTNAP. 
These bits are set to 0 when COMTNAP is assembled. The last word of the table must 
be 0. 

Each application defined in COMTNAP must appear only once. However, any 
application validation bit can appear more than once; that is, a given application 
validation bit can be defined to permit use of more than one application, if the 
operations at a particular site make such a definition desirable. Bits 47 through 36 of 
the application validation word are reserved for customer application use; bits 35 
through 15 are reserved for Control Data application use. 
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The released table defined by COMTNAP follows: 



Bit Position 

Application Name 

0 

IAF 

1 

RBF 

2 

TAF 

3 

MCS 

4 

TVF 

5 

CS 

6 

PLATO 

7 

ITF 

8 

TLF 

9 

NJF 

10 

NETOU 

11 

PSU 

12 

API 

13 

AP2 

14 

AP3 

15 

VEIAF 


The following table-related parameters are defined in COMTNAP. All symbols are 
unqualified. 

Parameter Default Description 

TNAV - Table first word address. Program that uses COMTNAP 

defines the value. 

TNAVL 178 Table length, excluding zero-word terminator. 
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PPCOM Parameters 


PPCOM contains the following parameters used by system peripheral processor 
packages for intercommunication. Assemble PPTEXT to obtain a listing of PPCOM. 


Parameter 

Default 

Description 

CCFL 

224B 

Initial field length of 100B assigned to CCLBRWE for 
prolog processing. Changes to CCL installation parameters 
may require adjustment of the value of this symbol. 

ESMX 

512D 

Maximum number of EST entries, plus one. The value for 
ESMX can range from 10 through 512. 

LCOM 

12s 

Maximum length of the L-display input buffer in words. 
The value for LCOM can range from 1 through 128. 

LDSY 

3508 

Maximum length of the L-display output buffer in words. 
The value for LDSY can range from 1008 through 10008. 

MSMX 

200D 

Maximum number of mass storage devices. The value for 
MSMX can range from 1 to 200. 

MXLF . 

128D 

Maximum number of local files. This value affects the 


maximum negative field length (see MNFL in PPCOM) 
and the maximum central memory field length available 
for a job. Both are calculated in multiples of 100B. The 
MXLF default of 128D gives a maximum negative field 
length of 1200B and a maximum user CM field length of 
376500B. Note that increasing MXLF (and thus increasing 
MNFL) reduces the amount of CM field length available 
for all user jobs. 

The assembly constant INSP$ is defined in PPCOM. If the INSP$ reference is deleted, 
10 bytes become available for site code in both the DSD display and the command 
overlays. 
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DSD Parameters 

The following parameters, specified in ENTER macro calls (within the DSD syntax 
tables), cause the first 25 characters of the associated DSD command to be logged in 
the system dayfile and/or the error log. The commands are logged just as they are 
entered by the operator except that the characters 

DS, 

are placed before each command. The DSD listing contains an explanation of the 
ENTER macro. Assemble DSD to obtain a listing. 

Parameter Default Description 

ERL - When specified in an ENTER macro call, the associated 

command is logged in the error log. On the release tapes, 
the OFF, ON, channel control, and memory commands 
specify ERL on their ENTER macro calls. 

SDF - When specified in an ENTER macro call, the associated 

command is logged in the system dayfile. 

819 PPU Driver Installation 

You can install the 819 PPU driver on the model 176 computer only. The 819 PPU 
driver resides on the system as a PPU-type record named HCD and is loaded into the 
first-level peripheral processors (FLPPs) during deadstart. If you have a new or updated 
version of this microcode, the deadstart tape must be updated to contain it. To build 
the 819 driver, execute the following command: 

BEGIN,HCD,INSTALL. 

Binaries from this job are copied to a permanent file named PRODUCT. 
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NSS - NOS Scope 2 Station Facility 1 

There are no special build instructions for NSS. For information about initiating SSF, 

refer to Subsystem Initiation at the beginning of this chapter. This section describes 

the following: 

• Configuration Information 

• Installation Procedure Messages 

• Spun-Off Task (SPOT) Memory Requirements 

• Installation Parameters 

Configuration Information 

To configure the NOS Scope Station Facility, create the following: 

• SSPOT user name. Create user name SSPOT for running the SSF subsystem. (The 
user name is created for you automatically in a first-time installation.) The 
password for this user name is (by default) STATION, but should be changed after 
installation is complete. The station has been tested with the following validations, 
some of which may not be necessary. 


MT=7 

DB=7 

RP=7 

LP=77B 

SC=50B 

CC=77B 

MS=77B 

DF=77B 

CM=20B 

SL=77B 

TL s 77B 

CP=77B 

AW=CLPF, CSPF, CCNR, CASF, CAND, CSRP, CSAP 


To change the user name or password, create a USER file which applies a 
modification set to change line NSSA000.4601 then run the NSS installation 
procedure. (File ZZSYSGU should also be updated to reflect the new user 
name/password. Refer to SYSGEN Validations in chapter 8 for more information.) 

• LIDCMid file. Entries in this file define the physical and logical machines 

available to your system. (The id in LIDCMid is the two alphanumeric characters 
from the MID CMRDECK entry which make up your machine identifier. The 
released default id is AA.) The number of entries in the LIDCMid file determine 
the value specified in the LDT CMRDECK entry. The LIDCMid file is stored as 
an indirect access permanent file on user name SYSTEMX (user index 377777B). 
In addition to entries in this file for NSS, entries are also made for dual state, 
RHF, and PTF/QTF. 

If you are installing dual state, a sample LIDCMid file is provided with the 
release materials. To examine this file, consult the DUAL section of this chapter. 
If you are not installing dual state, create the LIDCMid file on the installation 
user name using an available text editor. 


Revision L 


Special Product Installation Information 7-165 



NSS - NOS Scope 2 Station Facility 1 


To move the LIDCMid file to user name SYSTEMX, execute the following command 
from the system console when directed by the instructions in chapters 2, 3, or 4: 

SYSGENfMOVE,LIDCMid,SYSTEMX,,Y,PERMIT) 

(The PERMIT parameter allows read access to the file from the installation user 
name.) Once the file has been moved, build the LID table in central memory 
using the CLDT system program. To use CLDT, ensure that NAM, IAF, RHF, and 
SSF are not running and enter the following command from the system console: 

X.CLDT. 

CLDT is executed automatically at NOS deadstart time if an LDT entry exists in 
the CMRDECK. 

• LDT CMRDECK entry. This entry defines the size of the Logical Identifier Table 
in central memory. The size of the table is determined by the number of entries 
in the LIDCMid file. 

• CC EQPDECK entry. This entry defines the connection of each 6683 Satellite 
coupler to your mainframe. 

For more information about the LIDCMid file and LDT CMRDECK entry, refer to the 
LID/RHF Configuration Files section of the NOS Version 2 Analysis Handbook. 
Information about the CC EQPDECK entry plus additional information about the LDT 
CMRDECK entry can be found in the Deadstart Decks section of that manual. 

Installation Procedure Messages 

The DECKOPL installation procedure for NSS contains two errors. The following 
messages appear in the dayfile: 

COPYL DID NOT FIND — REL / MSC 

COPYL DID NOT FIND -- REL / SEC 

This condition is non-fatal and does not affect the generated binaries. The frequency of 
occurrence is relative to this product as released; any local code may change the 
frequency. 
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Spun-Off Task (SPOT) Memory Requirements 

The station control point MFSTAT handles all communication between the station and 
Scope 2. A SPOT is a job that MFSTAT initiates and places into the host mainframe 
input queue after MFSTAT detects a request for an I/O transfer or a staging operation. 
There are five unique SPOTs: permanent file SPOT, tape staging SPOT, spooling SPOT, 
dump SPOT, and deadstart SPOT. MFSTAT and all the SPOTs execute on the NOS 
mainframe. 

The spooling SPOT (SOT76) is the only SPOT that transfers more than one file. 

SOT76 is initiated when communication is established between mainframes and does 
not terminate until the station is dropped. All other SPOTs are initiated as required 
to transfer one file, and each is terminated after completion. 

Field length requirements fluctuate as file transfers are initiated and terminated. As 
file transfers are terminated, buffers are released. Definitions in the common deck 
COMTUNE control the lengths of the buffers used by the SPOTs. Each SPOT uses 
one of the COMTUNE SYMPL DEFs to determine the length of the I/O buffers. All 
SPOTs are written in the SYMPL language. 

Nominal release definition octal values for the I/O buffers are described in the 
following list. 


Name 

Value 

Description 

LBUFDP 

4001 

7000 dump 

LBUFDSLM 

7725 

Deadstart link buffer 

LBUFDSTP 

3004 

Deadstart via tape 

LBUFLM 

1401 

Link medium 

LBUFPF76 

5051 

Permanent file for 6000-7000 

LBUFSP 

2021 

Spooling 

LBUFTP 

6007 

Tape staging 


Buffers required to transfer a file vary among SPOTs. All SPOTs transfer a file 
between a NOS disk and a link medium device. For some SPOTs, this requires two 
separate buffers as data is converted. Other SPOTs use only one buffer. When two 
buffers are needed, the length of the link medium buffer is defined by LBUFLM, and 
the buffer for the disk is defined by the appropriate symbol (for example, LBUFSP for 
the spooling SPOT). 

Octal memory requirements for the various SPOTs are shown in table 7-10. 

SPOTs, like user jobs, may be rolled or swapped out as memory is needed. 

The relationship between buffer sizes and performance is bound by the same 
consideration as for any user job. The absolute minimum buffer size is a PRU + 2 
words. Any large reduction in buffer sizes from the release values has some impact 
on performance. 
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Table 7-10. SPOT Octal Memory Requirements 


SPOT Type 

Code 

Buffer Lengths 
Used to 
Transfer Files 

Total 

Memory 

Used 

Notes 1 

Deadstart 

6200 

LBUFDSTP + 
LBUFDSLM 

21200 

Via tape 

Dump 

4200 

LBUFDP 

10200 


Permanent file 

5100 

LBUFPF76 + 
LBUFLM 

11600 


Spooling 

10200 

LBUFSP+ 

LBUFLM 

14600 

Single file transfer 

Tape staging 2 

6700 

3*MBL+ 
LBUFLM/2 + 3 

11100 

For 

MBL < (LBUFTP-LBUFLM/ 
2-31/3 [7690] 



LBUFTP 

14700 

For (LBUFTP-LBUFLM/2-3)/ 

3 [7690] < MBL < LBUFTP- 
LBUFLM-1 [23090] 

* 


MBL+ 

LBUFLM + 1 

20500 

For MBL>LBUFTP- 
LBUFLM-1 [23090] 


1. Figures in brackets are the results using the released default values for the 
parameter variables in the equations. 


2. The buffer length required for tape staging depends on the value specified for the 
maximum block length (MBL) for tape staging operations. Use the equations in the 
Notes column to determine the appropriate values to use. The maximum value that 
can be specified for MBL is 50000. 
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Installation Parameters 

The following installation parameters are all on common deck COMTUNE on the NSS 
program library. Deck COMTUNE also lists the minimum and maximum values for 
•these parameters. 


Table Size Parameters 


Parameter Default 

DATAENT 0 

DISNAMESIZE 10 

IDTMAX 10 


MAXSPOTS 


NMF 1 

SNTS 11 

SPOOLS 4 

SYNTAXSIZE 200 


Description 

The maximum number of active data streams. 

The size of the display name table for the 
transparent display interface to the Scope 2 
operating system. 

The maximum size of the IDT table controls the 
number of logical IDs a mainframe can have and 
allows this value, minus two logical IDs. 

IDTMAX must match IDTL defined in PP 
program SSH; otherwise, SSH hangs the spooling 
SPOT until the station is dropped. 

A group of parameters that define the default 
maximum number of active SPOTs of each type 
that MFSTAT activates at one time. MAXSPOTS 
refers to a group of parameters; therefore, 
assemble deck COMTUNE for a list of default 
values. 

The number of mainframes to which the station 
can be linked; the maximum value that can be 
specified is 2. 

The size of the SPOT name table (SNT). The 
size of the SNT should be the value of 
DATAENT plus the maximum number of local 
SPOTs (four) plus the spooling SPOT (one). 

The maximum number of spooling streams. 

The size of the syntax extension table for the 
transparent display interface to the Scope 2 
operating system. 
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Spooling and Recalling Time Parameters 


Parameter 

Description 

BSYLIM 

The length of time in seconds the busy overlay of MFSTAT delays 
after sensing an idle condition, before going into an idle state. 

DSDWAIT 

The length of time in seconds that MFSTAT waits for a reply 
before it rejects a DSD request. 

IDLEMAX 

The elapsed time in seconds that MFSTAT waits after all spooling 
activity has completed before swapping out the spooling SPOT. 

IDLETIME 

The number of seconds the spooling SPOT waits before trying to 
initiate spooling operations. 

IDLETIME2 

The amount of time in seconds the spooling SPOT waits before 
initiating new spooling operations if output spooling is taking place. 

IDLRCLTM 

The recall time in seconds used by MFSTAT when the idle overlay 
is executing. 

Parameter 

Description 

ISEC(i) 

A way of approximating the number of idle station loops in 
i seconds. 

LOOPLIM 

The delay in seconds that MFSTAT waits before checking for a 
change in busy to idle status (controls the frequency with which 
the busy portion of the station checks its busy status). 

MAXINCOUNT 

The frequency in seconds with which MFSTAT checks the input 
queues for files to spool when it is idle. 

MSEC(i) 

Recall time in milliseconds. For example, MSEC(5) is equal to 5 
milliseconds. 

MSGCNT 

The length of time in seconds that MFSTAT leaves informative 
messages on the B display. 

OVLMAX 

The maximum time in seconds that MFSTAT retains the 
secondary overlay field length after a load of a secondary overlay. 

RCL7000 

The recall time in milliseconds used by the busy overlay of 

MFSTAT when communicating with a linked Scope 2 operating 
system. 

SEC(i) 

A method of approximating the number of busy station loops in 
i seconds. 

SPLLIM 

The number of seconds MFSTAT waits before going idle once 
spooling activity is completed. 


7-170 NOS Version 2 Installation Handbook 


Revision L 



NSS - NOS Scope 2 Station Facility 1 


Parameter 

Description 

SPOOLRCL 

The recall time in milliseconds used by the spooling SPOT when 
there is no spooling activity. 

STA7000 

The delay in seconds used by MFSTAT between sending status 
requests to the Scope 2 operating system. 

TIMOUT 

The length of time in seconds that MFSTAT waits before logging 
out a linked mainframe when communication is lost. 

TME7000 

The delay in seconds between sending time requests to the Scope 2 
operating system. 

NOTE 



For better response time, lower both the RCL and STA values. To reduce CPU use, 
increase the RCL value. If the RCL and STA parameters are reduced too much, 
however, the reduction may cause STD (the link medium coupler driver) to be locked 
in. 


Buffer Size Parameters 


Parameter 

Default 

Description 

DAYBUFSIZE 

220 

The size of the MFSTAT buffer for processing 
SPOT dayfiles on the active side. 

LBUFLM 

769 

The length of the link buffer used by SPOT jobs 
for NOS Scope 2 I/O spooling. 

LBUFPF76 

2601 

The length of the disk buffer used to read and 
write the disk for permanent file transfers to 
and from Scope 2. 

LBUFSP 

1041 

The length of the disk buffer used by the 
spooling SPOT for NOS Scope 2 spooling of I/O 
files. 

LICRBUF 

76B 

The length of the MFSTAT buffer used by the 
IAF queue utility helper. 

LRGBUF 

440B 

The size of the MFSTAT receive buffer for the 
active side of the station. 

RRBUF 

15B 

The size of the MFSTAT active transmit buffer 
and the linked staged packet buffer. 

The following installation parameter is in the deck HELL07: 

Parameter 

Default 

Description 

NOMFF 

1 

If NOMFF is set to 1, HELL07 supports a 


single mainframe. For multiple mainframe 
support, NOMFF must be set to 0. 


Revision L 


Special Product Installation Information 7-171 





PSU - Printer Support Utility Version 1.1 


PSU - Printer Support Utility Version 1.1 

There may be up to twelve printers connected to PSU, consisting of any mixture of 
533, 536, 537, 585, or Apple LaserWriter printers. If the printer’s configuration is not 
, correctly described in the default PSU EVFULFN file, changes to the file are required. 

I 

| This section describes the following: 

% 

| • Configuration Information 
| • Unique Parameters 
I • PSU Command 
| • File Placement 
| • NDL File Entries 

Configuration Information 

To configure the Printer Support Utility, create the following: 

| • Electronic Vertical Format Unit Load File (EVFULFN). This file sets default 

options for PSU and is stored as an indirect access permanent file on the network 
operations user name. The file contains legible text and may be modified in 
advance using the instructions below. 

For a first-time installation, GET EVFULFN from the network operations user 
name directly. If you are installing PSU for the first time during a NOS upgrade 
or as part of a component order, execute the SYSGEN(PSUl) procedure from the 
installation user name to load a copy of EVFULFN and the PSU NAMSTRT 
records to the installation user name (file NAMSTRT is required). 

To move the EVFULFN file to the network operations user name, execute the 
following command from the system console: 

SYSGEN(MOVE,EVFULFN, netopun ,,Y,PERMIT) 

Refer to the instructions in chapter 2, 3, or 4. (The PERMIT parameter allows 
read access to the file from the installation user name.) 

• Validation file entries. PSU requires user names validated for the PSU application 
to print files. User names are of the form PRINTnn, where nn is a 2-digit 
number. These user names are referenced in the EVFULFN file. SYSGEN creates 
user names PRINT01 through PRINT12. 

• PCFid file. If you are installing PSU as part of an upgrade or component order, 
you must purge file PCFid from user name SYSTEMX. The id in PCFid is the 
2-character alphanumeric identifier from your MID CMRDECK entry. 


7-172 NOS Version 2 Installation Handbook 


Revision L 



PSU - Printer Support Utility Version 1.1 


To configure a printer that is connected to a 255x NPU, create the following: 

• NDL file entries. Entries are required in the Network Configuration File (NCF) 
and Local Configuration File (LCF) portions of a Network Definition Language 
(NDL) file. A LINE statement in the NCF is required to define the connection 
between the NPU and the printer and a USER statement in the LCF is required 
to automatically connect and log the printer into the system. The user name 
specified on the USER statement is used by PSU to determine the class 
(attributes) of the printer. This association is made in the EVFULFN file. 

A sample NDL file containing the required entries is provided with the release 
materials. To examine this file, consult the NAM5 section of this chapter. In 
addition, the NAM5 section contains information on how to produce the LCFFILE 
and NCFFILE using the Network Definition Language Processor (NDLP) to 
compile the NDL file. Refer to NDL File Entries in this section for more 
information. 

• EVFULFN file entries. The entries in this file define the class (characteristics) of 
the printer that uses each PRINTnn user name. 

If the printer is a 533 or 536, use user names PRINT01-PRINT04 or change 
EVFULFN to use a user name with printer class C536INT. All user names using 
printer class C536INT must be defined last (i.e., these user names must follow all 
user names that use some other printer class). 

If the printer is a 537 or other asynchronous printer, use user names 
PRINT05-PRINT06 or change EVFULFN to use a user name with printer class 
INTNVFU (Interactive with No VFU). 

Note the CDC 585 URI printer is only supported by CDCNET. 

To configure a printer that is connected to a CDCNET MTI or TDI, create the 

following: 

• NDL file entries. Entries are required in the Local Configuration File (LCF) 
portion of a Network Definition Language (NDL) file. A USER statement in the 
LCF is required to automatically connect and log the printer into the system. The 
user name specified on the USER statement is used by PSU to determine the 
class (attributes) of the printer. This association is made in the EVFULFN file. 

A sample NDL file containing the required entries is provided with the release 
materials. To examine this file, consult the NAM5 section of this chapter. In 
addition, the NAM5 section contains information on how to produce the LCFFILE 
and NCFFILE using the Network Definition Language Processor (NDLP) to 
compile the NDL file. Refer to NDL File Entries in this section for more 
information. 

• CDCNET Configuration File entries. A DEFINE_LINE statement must appear in 
the system configuration file for the DI to define the connection between the DI 
and the printer. A terminal definition procedure (TDP) is also required for proper 
configuration of the printer. Where possible, it is desirable to create a VFU Load 
Procedure for your printer. These procedures may be defined for CDC 533, 536, 
537, and 585 (URI) printers. An Apple LaserWriter may not have a VFU Load 
Procedure but must have a File Prefix Procedure. 

Sample CDCNET configuration files are provided with the release materials. Refer 
to the CDCNET Configuration and Site Administration Guide for a description of 
these files. 
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• EVFULFN file entries. The entries in this file define the class (characteristics) of 
the printer that uses each PRINTnn user name. 

If the printer has a defined CDCNET VFU Load Procedure, use user names 
PRINT09-PRINT12 or change EVFULFN to use a user name with printer class 
BATWVFU (Batch with VFU). This could include the CDC 533, 536, 537, and 585 
(or other URI printers) printers. 

If the printer does not have a defined CDCNET VFU Load Procedure, use user 
names PRINT07-PRINT08 or change EVFULFN to use a user name with printer 
class BATNVFU (Batch with No VFU). This would include an Apple LaserWriter 
printer. 

For more information about PSU, consult the PSU section in the NOS Version 2 
Analysis Handbook. 

| Unique Parameters 

& 

| Parameter Description 

| NOTRACE To disable AIP trace file creation, specify the keyword NOTRACE on 
the call to the PSU installation procedure. 

PSU Command 

The following command initiates PSU: 

PSU. 

The PSU command is in the PSU startup procedure file, which is part of the 
NAMSTRT file. Thus, PSU is started automatically with the network. 


File Placement 

There are two files that must be moved for PSU: the NAM startup master file 
NAMSTRT and the electronic vertical format unit load file EVFULFN. 

| 

| If you rebuild NAM, execute the command SYSGEN(PSUl) from an interactive 
| terminal logged in to your installation user name to add the PSU record to 
I NAMSTRT. SYSGEN(PSUl) requests your released permanent file tapes and loads 
| the file PFGPSU1. This file contains the released NAMSTRT records and a sample 
| EVFULFN. The EVFULFN file must be installed to the network operations user 
| name. For more information about the EVFULFN file, refer to the NOS Version 2 
| Analysis Handbook. 

You can move the NAMSTRT and EVFULFN files to the appropriate user names by 
using the SYSGEN(MOVE) command (refer to chapter 8). 
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NDL File Entries 

For each printer connected to PSU on a 255x NPU, you must include the following 
Network Definition Language (NDL) statements: 

• A LINE statement in the Network Configuration File (NCF) with the following 
format: 

1inex: LINE,PORT=port x,LTYPE=A2,TIPTYPE=ASYNC,LSPEED=9600. 

• A TERMDEV statement in the NCF with the following format: 

devicex: TERMDEV,TC=721,AUTOCON,HN=host node,LK=YES,OC=YES,PA=0,PW=0, 

PL=0,ABL=3,DBL=2. 

• A USER statement in the Local Configuration File (LCF) with the following 
format: 

devicex: USER,MFAM=family,MUSER=PRINTnn,MAPPL=PSU. 

Parameter Description 

devicex Device name for a PSU printer. 

family Name of the family containing user name PRINTnn, where nn is 

a 2-digit number. User name PRINTnn must be validated to use 
PSU. 

hostnode Node number of the host coupler to which the PSU printer is 

connected. 

linex Line name for a PSU printer. 

portx Port number for a PSU printer line. 

The released NDL file NDLDATA (located on the network administration user name) 
contains definitions for two PSU printers. 
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QU3 - Query Update Version 3 

The installation tool SYNGEN, and the various common decks that reside on the DDL3 
program library, must be available for the installation of Query Update 3. 

The QU3 interface to the Database Utilities, version 1, for CRM logging is provided 
by releasing the DBU relocatable binaries needed to load the QU/CRM logging 
capsule, CAPLOG, on the permanent file tapes. SYSGEN(SOURCE) loads this file to 
the installation user name. The QU3 installation procedure contains commands to 
access this file and to create a temporary library, DBULIB, to be used at load time. 
The procedure also contains commands to add the command-callable portion of DBU 
(DFRCV) to the PRODUCT file, thus allowing inclusion of DFRCV in the deadstart 
tape. No special definitions are required to access this interface. 

NOTE _ 

QU3 has several installation options that are affected by changing parameters in 
common decks NUMOPT and TOPTION. Refer to QU3’s program library for detailed 
explanations of all QU3 installation options. 
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RBF5/RBF5D - Remote Batch Facility Version 1 

This section describes the following installation options for RBF5: 

• Special Notes 

• Unique Parameters 

• RBF Command 

• USER File Directives 

• File Placement 

Special Notes 

RBF5 binaries are released on the deadstart tape in non-debug/trace mode. Control 

Data provides debug/trace binaries of RBF5 on the permanent file tapes. To obtain 

these binaries, use the SYSGEN(SWAP) function as described in chapter 8. 

Unique Parameters 

Parameter Description 

NOTRACE To disable log file creation for RBF5, specify the keyword NOTRACE 
on the call that executes the RBF5 installation procedure. (This option 
is not available for RBF5D.) 

RBF Command 

RBF5 requires the following command: 

RBF2P0(MC=mc) 

Parameter Description 

MC = mc Maximum message count; specifies the maximum number of 

messages to be accumulated in the debug log file before NETREL 
is called. By default, the MC parameter picks up its value from 
NAMSTRT. No NETREL call is issued if me is 0. This parameter 
is optional; no NETREL call is issued if MC is omitted. If 
NETREL is to be called, file NRF1 must be assigned to the 
control point before the command is executed. File NRF1 must 
contain a valid job record for writing to the ZZZZZDN file. The 
released RBF job skeleton record creates NRF1 from the job input 
record. 
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USER File Directives 

To assemble various features into RBF, include directives of the form: 
•DEFINE name 


in a USER file for the RBF5 installation procedure. 

Name Significance when Defined 

DEBUG Code to aid in debugging and maintenance is generated. 

IMS Descriptive internal maintenance comments are included in the assembly 

and compilation listings. 

TRACE Symbolic table dumps of RBF are written to file SPITOUT when RBF 

fails. 


The following parameters are defined in the common deck IP$COM. To make changes 
to these parameters, place appropriate Update directives on a USER file for the RBF5 
installation procedure. 


Default 

Parameter _ (decimal) 

ALOTIME 600 


MAXFL 


REFRESHTIME 30 


RESUMETIME 20 


SEARCHTIME 

15 

STATIONS 

16 

TOTDEV 

32 


Description 

Time in seconds that a dial-in terminal is allowed 
to remain inactive before being timed out of RBF. 

A value of 0 specifies that terminals are not timed 
out of RBF. The maximum value allowed is 4095. 

Maximum field length to which RBF expands when 
obtaining buffers. If TRACE is defined, the default 
value is 100000; if TRACE is not defined, the 
default value is 50000. 

Refresh period in seconds for the RBF console 
queue displays when RBF is specified on the 
DISPLAY command; should be larger than 
RESUMETIME. 

Time interval in seconds between receipt of the last 
interactive message and the automatic switching of 
the terminal to batch mode; should be larger than 
SEARCHTIME. 

Time interval in seconds between scans of the 
output queue for remote batch files. These times are 
increased by approximately 10 seconds when the 
load on RBF is light and when most of RBF’s field 
length is rolled out to disk. 

Maximum number of consoles. 

Maximum number of batch devices. 
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File Placement 

Execution of the RBF5 installation procedure requires a prior build of NAM and the 
existence of the NAM startup master file on the installation user name. The RBF5 
installation procedure modifies the NAM startup master file (NAMSTRT). For more 
information about the network startup master file, refer to the NAM5 section of this 
chapter. 
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RDFEX - Remote Diagnostic Facility 

RDFEX and IAF share decks IAFEX and 1TM in the composite OPL (OPLpsrout). Both 
products must be rebuilt if user code is applied to either of these decks. That is, user 
code must be included for both the RDFEX and IAF build procedures. 
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RHF - Remote Host Facility Version 1 

This section describes the following installation options for RHF: 

• Configuration Information 

• RHF Procedure File 

• Hardware Configuration 

• Installation Parameters 

• NAD Microcode 

Configuration Information 

To configure the Remote Host Facility, create the following: 

• RCFMid File. Entries in this file define loosely coupled network (LCN) elements. 
These include Network Access Devices (NADs), applications, and mainframe 
physical identifiers (PIDs) for all LCN configurations used by or accessible to RHF 
on your mainframe. (The id in RCFMid is the two alphanumeric characters from 
the MID CMRDECK entry which make up your machine identifier. The released 
default id is AA.) The RCFMid file is stored as a direct access permanent file on 
user name SYSTEMX (user index 377777B). This file should be created or edited 
on the installation user name then moved to user name SYSTEMX. 

To create the RCFMid file, first make a file containing network configuration 
statements on the installation user name. This file is then processed by the 
system utility RCFGEN to produce RCFMid. An example sequence of commands is 
given below: 

1. Create RCFGEN input using an available text editor. (This example uses the 
file name rcfin.) 

2. If you are installing RHF as part of a system upgrade or a component order 
(and have therefore not deadstarted the system containing the new level of 
RCFGEN), access the new version from GLOBLIB: 

ATTACH,GLOBLIB. 

LIBRARY,GLOBLIB/A. 

3. Execute RCFGEN: 

RETURN,RCFMid. 

PURGE,RCFMid. (Be sure to PURGE any previous file.) 

DEFINE,RCFMid. 

REPLACE,ref in. 

RCFGEN,I=rcfin,L=1ist,0=RCFMid. 

RETURN,RCFMid. 

File list will contain any diagnostic messages from RCFGEN. 

To move the RCFMid file to user name SYSTEMX, execute the following 
command from the system console when directed to do so in chapter 2, 3, or 4: 

SYSGEN»MOVE,RCFMid,SYSTEMX. 
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• LIDCMid file. Entries in this file define the physical and logical machines 
available to your system. (The id in LIDCMid is the 2-character alphanumeric 
identifier from the MID CMRDECK entry. The released default id is AA.) The 
number of entries in the LIDCMid file determine the value specified in the LDT 
CMRDECK entry. The LIDCMid file is stored as an indirect access permanent file 
on user name SYSTEMX (user index 377777B). In addition to entries in this file 
for RHF, entries are also made for dual state, Remote Host Products (PTF/QTF), 
and the NOS Scope Station Facility. 

If you are installing dual state, a sample LIDCMid file is provided with the 
release materials. To examine this file, consult the DUAL section of this chapter. 

If you are not installing dual state, create the LIDCMid file on the installation 
user name using an available text editor. 

To move the LIDCMid file to user name SYSTEMX, execute the following 
command from the system console when directed to do so in chapter 2, 3, or 4: 

SYSGEN,MOVE.LIDCMid,SYSTEMX,,Y,PERMIT. 

(The PERMIT parameter allows read access to the file from the installation user 
name.) Once the file has been moved, build the LID table in central memory 
using the CLDT system program. To use CLDT, ensure that IAF, NAM, RHF, and 
SSF are not running and enter the following command from the system console: 

X.CLDT. 

(CLDT is executed automatically at NOS deadstart time if an LDT entry exists in 
the CMRDECK.) 

• LDT CMRDECK entry. This entry defines the size of the Logical Identifier Table 
in central memory. The size of the table is determined by the number of entries 
in the LIDCMid file. 

• NC EQPDECK entry. This entry defines the connection of each Network Access 
Device (NAD) to your mainframe. 

For more information about the RCFMid file, LIDCMid file, and LDT CMRDECK 
entry, refer to the LID/RHF Configuration Files section of the NOS Version 2 Analysis 
Handbook. Information about the NC EQPDECK entry and additional information about 
the LDT CMRDECK entry can be found in the Deadstart Decks section of that manual. 

RHF Procedure File 

The entry point of the RHF subsystem is named RHF. Therefore, you can initiate RHF 
without a procedure file with the DSD entry RHF. 

If you want to initiate RHF with a procedure file, create an RHF procedure file. If 
you create such a file, it must contain a RETURN,RHF command to return the local 
file RHF before the call to RHF. For example, 

.PROC.RHFffff,... 

RETURN,RHF. 

local site commands 

RHF. 

RHFffff can be a procedure file stored in an indirect access permanent file under 
SYSTEMX (user index 377777s). 


7-182 NOS Version 2 Installation Handbook 


Revision L 



RHF - Remote Host Facility Version 1 


Refer to the beginning of this chapter for more information about subsystem 
initiation. 

Hardware Configuration 

RHF and its applications require the same minimum hardware configuration as NOS 
plus a minimum of one 380-170 Network Access Device (NAD). 

Switch settings on the NAD are critical. Many switch settings (such as access code, 
NAD address, TCI enable, and so on) must be correct to obtain any response from 
the NAD. The RESYNC and CONTENTION parameters, if not set properly, can 
cause occasional trunk errors. For example, if two NADs connected by one trunk 
have the same RESYNC parameter, a file transfer in one direction may fail with a 
broken connection. Set the CONTENTION/RESYNC parameter as follows: on any 
given trunk, the RESYNC parameter for each NAD should be unique and should be 
less than the value (2*contention number) + 2. Refer to the 380-170 Network Access 
Device Hardware Reference Manual for further information. 
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Installation 

Parameter 

FETBUFSIZE 


MAXFILEXFR 


Parameters 

Description 

The number of words assigned to buffer space for each file transfer. 
Values may be zero or greater, but FIP overrides low values. The 
current definition format is as follows: 

1 7 22 

DEF FETBUFSIZE #3200#; 

Assigned Assigned 

FETBUFSIZE (binary) (coded) 


0 to 532 532 992 

532 to 992 532 to 992 992 

992 and up 992 and up 992 and up 

The default value for FETBUFSIZE is 3200, which corresponds to 
about 49 PRUs. Values larger than 6400 (98 PRUs) do not increase 
transfer rates appreciably and make job swapping more likely 
because of the increased central memory required. 

The change deletion location is in common deck COMADEF. The 
following is an example of a parameter change: 

DEF FETBUFSIZE #2800#; 

The maximum number of file transfers that the Facility Interface 
Program (FIP) allows for any one application. Values may range 
from 1 through 10. Default is 4. The current definition format is: 

1 7 22 

DEF MAXFILEXFR #4#; 

The change deletion location is in common deck COMADEF. The 
following is an example of a parameter change. 

DEF MAXFILEXFR #5#; 
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NAD Microcode Initialization Parameters 

A set of initialization parameters must be loaded into NAD memory along with the 
NAD microcode as documented in the 380-170 Network Access Device Hardware 
Reference Manual. These parameters are compiled into MHF and are appended to all 
NAD microcode loads. The default values provide for a maximum of 25 remote NADs, 
24 paths, use of all available NAD memory, and no NAD buffer tracing. To change 
any of the initialization parameters, you must modify the default values and reinstall 
RHF. MHF attempts to maximize NAD memory use by allocating as much memory as 
possible to NAD buffers. This automatic allocation is defeated if the NAD memory size 
initialization parameter is set to nonzero. This parameter should not be changed 
without a thorough understanding of NAD microcode memory use. 

NAD buffer tracing can be controlled when generating the RHF configuration file. 

Refer to the TRACE parameter on the LNAD statement, described in the LID/RHF 
Configuration Files chapter of the NOS Version 2 Analysis Handbook. 

NAD Microcode 

NAD microcode resides on the system as a PPU-type record named 170. You can load 
NAD microcode during RHF initialization or by operator request. 

To build NAD microcode, submit the following job. The binaries produced by this job 
are copied to permanent file PRODUCT. 

job command. 

USER,username,password,fami 1yname. 

LABEL,TAPE,F=f mt,t apet yp,D=densit y,LB=KU. 

NOTE, IN.+*COMMENT PPU/170 170 FIRMWARE MG401-xxx(PNyyyyyyyy) 

COPYBF,TAPE.INHOLD. 

BEGIN,170.INSTALL. 

-eoi- 


Parameter 

Description 


density 

Tape density. For example, PE or 

GE. 

fmt 

Format of tape. For example, I or 

SI. 

tapetyp 

Tape type. For example, MT or NT. 

XXX 

Version level. For example, DOS. 


yyyyyyyy 

Part number. For example, 12345678. 
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RHP - PTF/QTF File Transfer Facility 

This section describes the following options for RHP: 

• Configuration Information 

• Unique Parameters 

• Installation Parameters 

• QTF Initiation Procedure Parameters 

• QTF Configuration Directives 

Configuration Information 

To configure the PTF/QTF File Transfer Facility, create the following: 

• RCFMid file. Entries in this file allow PTF/QTF file transfers to take place using 
an RHF LCN network. The entries define the PTF/QTF applications (APPL 
statements) and the interhost and intrahost application-to-application connections 
(NPID, LNAD, RNAD, and PATH statements). Refer to the RHF section of this 
chapter for more information. 

• LIDCMid file. Entries in this file define the physical and logical machines 
available to your system. (The id in LIDCMid is the two alphanumeric characters 
in the MID CMRDECK entry. The released default id is AA.) The number of 
entries in the LIDCMid file determine the value specified in the LDT CMRDECK 
entry. The LIDCMid file is stored as an indirect access permanent file on user 
name SYSTEMX (user index 377777B). In addition to entries in this file for 
PTF/QTF, entries are also made for dual state, the Remote Host Facility (RHF), 
and the NOS Scope Station Facility. 

If you are installing dual state, a sample LIDCMid file is provided with the 
release materials. To examine this file, refer to the DUAL section of this chapter. 
If you are not installing dual state, create the LIDCMid file on the installation 
user name using an available text editor. 

To move the LIDCMid file to user name SYSTEMX, execute the following 
command: 

X.SYSGEN(MOVE,LIDCMid,SYSTEMX,,Y,PERMIT) 

from the system console when directed to by instructions in chapters 2, 3, or 4. 
(The PERMIT parameter will allow read access to the file from the installation 
user name.) Once the file has been moved, build the LID table in central memory 
using the CLDT system program. To use CLDT, ensure that IAF, NAM, RHF, and 
SSF are not running and enter the following command from the system console: 

X.CLDT. 

(CLDT is executed automatically at NOS deadstart time if an LDT entry exists in 
the CMRDECK.) 

• LDT CMRDECK entry. This entry defines the size of the Logical Identifier Table 
in central memory. The size of the table is determined by the number of entries 
in the LIDCMid file. 
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• NDL file entries. Entries in the Local Configuration File (LCF) portion of a 
Network Definition Language (NDL) file allow PTF/QTF file transfers to take 
place using a NAM/CCP network or a NAM/CDCNET network. The entries define 
the PTF/QTF applications (APPL statements) and the interhost and intrahost 
application-to-application connections (INCALL and OUTCALL statements). 

Transfers using a NAM/CCP network require entries in the Network 
Configuration File (NCF) portion of the NDL file. For non-X.25 transfers, 
LOGLINK statements (and possibly TRUNK statements) define host-to-host logical 
links. For X.25 transfers, LINE statements define the network’s X.25 connection. 
The NPU that contains the X.25 line must use a variant containing the X.25 and 
X.25 A-A TIPs (referenced by the NPU statements VARIANT parameter). 

Transfers using a NAM/CDCNET network require the network products gateway 
to CDCNET to be defined using the DEFINE_NP_GW command in the 
configuration file for the Mainframe Device Interface (MDI) that contains the X.25 
line. 

A sample NDL file containing PTF/QTF application definitions is provided with 
the release materials. To examine this file, refer to the NAM5 section of this 
chapter. Also in the NAM5 section is information on how to produce the 
NCFFILE and LCFFILE using the Network Definition Language Processor (NDLP) 
to compile the NDL file. 

• NLFFILE variant. X.25 transfers using a NAM/CCP network require that the 
NPU with the X.25 line use an NPU variant which includes the X.25 and X.25 
A-A TIPs. The NPU load file variant is contained in the Network Load File, 
NLFFILE. This variant is referenced from the VARIANT parameter on a NPU 
statement in the NDL file. 

If CCP option A or B was ordered from the OIP, the released CCP load file 
contains a variant defining X.25. For a complete list of attributes for the released 
CCP load file, refer to the CCP section of this chapter. 

The file PFGRHP1 on the permanent file tape contains the NAMSTRT records that 
allow PTF/QTF to.transfer files over a NAM/CCP or NAM/CDCNET network. 

For more information about the LIDCMid file and LDT CMRDECK entry, refer to the 
LID/RHF Configuration Files chapter of the NOS Version 2 Analysis Handbook. For 
additional information about the LDT CMRDECK entry, refer to the Deadstart Decks 
chapter of that manual. For information about the NDL entries, refer to the Network 
Definition Language Reference Manual. 

For information about the CCP NLFFILE, as well as sample configurations that use 
PTF/QTF, refer to the CCP section of this chapter. For information about the 
DEFINE_NP_GW command, refer to the CDCNET Configuration and Site 
Administration Guide. 
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Unique Parameters 

Parameter Description 

SUBSYS=subsys To install the file transfer applications to interface with RHF or 
NAM or both subsystems, use the SUBSYS=subsys parameter. 
The values you can specify are RHF, NAM, or BOTH. The 
default is SUBSYS=RHF. 

TRACE To enable AIP/FIP tracing, include the keyword TRACE on the 

procedure call. 

DEBUG To enable full debug code, include the keyword DEBUG on the 

procedure call. Unsupported code for debugging purposes when 
writing and testing RHF components is available by including the 
E and C parameters on all SYMPL compiler commands and 
PC = DEBUG on all COMPASS commands. This code is not 
normally compiled or assembled and is not intended for a 
production environment. 

Table 7-11 shows the binaries that are built depending on which subsystem..you have 

specified. 

Table 7-11. Binaries Built 



SUBSYS=RHF 

SUBSYS=NAM 

SUBSYS = BOTH 

PTF 

MFLINK 

MFLINK 

MFLINK 


FTF0100 

FTF0300 

FTF0500 


FTF0200 

FTF0400 

FTF0600 

FTF0700 

PTFS 

PTFS 

PTFSN 

PTFS 


PFS0100 

PFS0300 

PFS0100 


PFS0200 

PFS0400 

PFS0200 

PTFSN 

PFS0300 

PFS0400 

QTF 

QTFI 

QTFIN 

QTFI 


QTF 

QTF 

QTFIN 

QTF 

QTFS 

QTFS 

QTFSN 

QTFS 


QFS0100 

QFS0300 

QFS0100 


QFS0200 

QFS0400 

QFS0200 

QTFSN 

QFS0300 

QFS0400 

MFQUEUE 

MFQUEUE 

MFQUEUE 

MFQUEUE 
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Installation Parameters 

For information about MFLINK requests and auxiliary pack options, refer to the APLO 
parameter under the NOS COMSPFM deck in this chapter. 

Parameter Description 

ACNMAXC The maximum number of connections that the queue file transfer facility 
(QTF) can have active at any one time. Values can range from 1 
through 10; the default is 4. (Lower values reduce QTF’s memory 
requirements, but may also reduce the number of queue files transferred 
simultaneously.) The current definition (acceptable to both COMPASS 
and SYMPL) is as follows: 

1 11 18 24 36 

#ACNMAXC #DEF# 4 #ACNMAXC #40; 

The change deletion location is in common deck COMCAPR. The 
following is an example of a parameter change: 

#ACNMAXC #DEF# 2 #ACNMAXC #2#; 

MAXRTRY The number of retries that an application attempts to successfully 

complete a file transfer if errors other than temporary connection rejects 
occur. Values may range from 1 through 50. Default is 10. The current 
definition format (acceptable to both COMPASS and SYMPL) is as 
follows: 

1 11 18 24 34 

0MAXRTRY #DEF# 03D 0MAXRTRY #03#; 

The change deletion location is in common deck COMCAPR. The 
following is an example of a parameter change. 

#MAXRTRY #DEF# 20D 0MAXRTRY #20#; 

TIMEOUT The time in seconds (assuming a job scheduler cycle of 1 second) in 
which a response must be received from the remote application before 
the connection is broken. Values may range from 1 through 1800. 

Default is 600. The current definition format (acceptable to both 
COMPASS and SYMPL) is as follows: 

1 11 18 24 34 

#TIMEOUT #DEF# 600D #TIMEOUT #600#; 

The change deletion location is in common deck COMCAPR. The 
following is an example of a parameter change. 

#TIME0UT #DEF# 400D #TIMEOUT #400#; 


Revision L 


Special Product Installation Information 7-189 


RHP - PTF/QTF File Transfer Facility 


QTF Initiation Procedure Parameters 

The QTF initiation procedure has two parameters. For a full description of these 
parameters, refer to the NOS Version 2 Analysis Handbook. 

QTF Configuration Directives 

Refer to the NOS Version 2 Analysis Handbook for information about modifying QTF 
configuration directives. 
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SORT5 - Sort/Merge Version 5 

This section describes the installation procedure messages for Sort/Merge Version 5. 


Installation Procedure Messages 

The DECKOPL installation procedure for SORT5 contains an error. The following 
message appears in the dayfile: 

COPYL DID NOT FIND — REL /S$ISQRT 

This condition is non-fatal and does not affect the generated binaries. The frequency of 
occurrence is relative to this product as released; any local code may change the 
frequency. 
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TAF - Transaction Facility Version 1 

For an overview of the TAF installation process, refer to the installation overview 

appendix in the TAF Reference Manual. 

This section describes these installation options for TAF: 

• Unique Parameters 

• Task Library 

• TAF Procedure File 

• TAF Validation Requirements 

• Installation Parameters 

Unique Parameters 

Parameter Description 

DEBUG To get the trace feature, specify the keyword DEBUG on the call to the 

TAF installation procedure. 

NOLOG To not assemble the TAFLOG binary (which requires COBOL5), specify 

the keyword NOLOG on the call to the TAF installation procedure. 

TASKLB To create a task library (refer to Task Library later in this section), 

specify the keyword TASKLB on the call to the TAF installation 
procedure. 
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Task Library 

Before running the TAF installation procedure, create a task library permanent file 
containing the following required tasks: 


Task 


Description 


BTASK Task that recovers transactions initiated by BTRAN. 

CRMTASK Task that formats TAF/CRM Data Manager file status displays. 

CTASK Task to recover transactions using the TAF/CRM Data Manager. 

ITASK Initial task. 

KDIS TAF K display driver. 

LOGT Task to log out transaction terminal from TAF. 

MSABT Diagnostic generator for abnormally terminating tasks. 

OFFTASK Inactive task controller. 

RCTASK Task that recovers CDCS transactions. 

RTASK Task to recover terminals. RTASK may be on the task library 

permanent file or on database libraries. 

STASK Send message then cease. 

SYSMSG Message task for system origin messages. 

XTASK Execute named task. 

If TAF is used in a multimainframe complex, the system does not allow concurrent 
access to the same database. A copy of TAF in each computer must have its own user 
name/user index or default family. 


TAF Procedure File 

Refer to Subsystem Initiation, at the beginning of this chapter, for information about 
the subsystem startup file and subsystem initiation. 

The user name required by TAF (KB100DC) is created automatically by SYSGEN if 
no validation file exists. 


TAF Validation Requirements 

If you have no validation file, SYSGEN creates the necessary user name and password 
for running TAF - user name KB100DC and password TAFPASS under user index 16 
octal. The user name is used by SYSGEN to install the released TASKLIB file and for 
TAF operations. To change the password, supply a USER directive in the TAF file. To 
change the user name or user index, reassemble TAF changing the USNM and TRUI 
micros. These micros are set in deck COMKIPR. (File ZZSYSGU should also be 
updated to reflect the new user name and password. Refer to SYSGEN Validations in 
chapter 8 for more information.) 
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Installation Parameters 


The following parameters are defined in deck COMKIPR. These parameters specify the 
charge and project numbers and user index for TAF. They also specify the user name 
and family under which TAF runs. 


Parameter 

Default 

Description 

CGNM 

A null 
micro 

Micro whose string specifies the charge number for TAF; 
used when a dump is performed. If CGNM is null, no 
CHARGE command is issued, and the user name specified 
by USNM must not require a CHARGE command. 

FMLY 

A null 
micro 

Micro whose string specifies the family under which 
DMREC will locate TAF’s xxJ files. FMLY must be set 
only if databases are defined on families other than the 
family that contains the xxJ files. That is, if all databases 
and xxJ files are defined on the same family, you do not 
need to set the FMLY parameter. 

PJNM 

A null 
micro 

Micro whose string specifies the project number for TAF. 

TRUI 

16B 

User index for TAF. 

USNM 

KB100DC 

Micro, whose string specifies the user name under which 
TAF runs. 

The following parameters specify the default initialization K display options. 

Parameter 

Default 

Description 

ECSFL 

0 

Extended memory field length/1000s. ECSFL cannot be 
less than 0 nor greater than 4008. 

NCMB 

40 

Actual number of communication blocks allowed in the 
subsystem. Communication blocks hold incoming terminal 
input. This parameter can be changed by the initialization 
command K.CMB, but it cannot be less than 19 nor 
greater than 40. 

NSCP 

31 

Maximum number of subcontrol points. It cannot be less 
than 2 nor greater than 31. 

SCMFL 

376600B 

Maximum field length. SCMFL cannot be less than 400008 
nor greater than 3766008, and must be set to a value that 
can be attained. 

TLFM 

TASKLIB 

Micro whose string specifies the system task library file 


name. 
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The following parameters, defined in deck TAF, specify the default DSDUMP 
parameters. The user can override the parameters specified on CMDUMP requests with 
a task. 

Parameter Default . Description 

Exchange package dump flag: 

Value Description 

0 Exchange package is not dumped. 

1 Exchange package is dumped. 

First word address in octal for task dump. 

Last word address in octal for task dump. 

Origin code. 

Output disposition (corresponds to OQ parameter on 
DSDUMP/CMDUMP requests): 

Value Description 

0 Local batch output queue. 

1 Remote batch output queue. 

2 Direct access permanent file. 

Refer to the TAF Reference Manual for further 
information. 

DSQID 0 Batch identification (ID) code for output of jobs entered in 

the input queue by the task SUBMT request. The system 
assigns this ID to the output from jobs containing a 
SETJOB,DC = DF command. DSQID ranges from 0 through 
67g. 


DEXP 

1 

DFWA 

0 

DLWA 

100000B 

DORC 

BOOT 

DORT 

0 
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Unless otherwise specified, the following parameters are defined in deck COMKIPR. 
These parameters specify the default time dependencies. Although these values are 
expressed in milliseconds, they are accurate to only 1 second. 


Parameter 

Default 

Description 

CORTL 

1*1000 

Frequency TAF checks to see if memory can be released 
to the system. 

DMMTL 

4 

Time allowed to elapse between calls to the data 
managers. 

ITRTL 

1500 

Time to wait for input before rollout of transaction 
executive field length. ITRTL is defined in deck TAF. 

RRTTL 

1*1000 

Time allowed to elapse before evicting a reusable task. 

TACTL 

2*60*1000 

Time allowed to elapse between TAF receiving any input 
and TAF generating a call to ITASK. TACTL is defined in 
deck TAF. 

TROTL 

10*60*1000 

Duration of rollout. TROTL is defined in deck TAF. 

TSKTL 

120 

Task time slice in milliseconds. 

The following parameters, defined in deck TAF, specify default task rollout parameters. 

Parameter 

Default 

Description 

DWITL 

8*60 

Time in seconds that a task is allowed to wait for 
terminal input before aborting. The user can override this 
parameter with the WAITINP request. 

NESTL 

16 

Nest limit for CALLRTN (must be less than 64). 

RTDNL 

2*1000 

Number of milliseconds a task is allowed to remain in 
memory waiting for a CALLRTN to complete. 
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Unless otherwise specified, the following parameters are defined in deck COMKIPR. 
These parameters specify other default TAF installation parameters. 


Parameter 

Default 

Description 

DTSTL 

16 

Number of time slices for a task. The user can override 
DTSTL for an individual task with the ITL request. 

DTSTL is defined in deck TAF. 

DTYM 

DI 

Micro whose string specifies the device type for journal 
files. 

IFL = 

200000B 

Initialization field length; defined in deck TAF. This value 
must be large enough to load the Application Interface 
Program (AIP) required for NAM interface, and the 
desired data managers and various tables required by 

TAF during initialization. If the message MEMORY 
OVERFLOW DURING INITIALIZATION is issued, either 
increase IFL= or decrease the databases, the number of 
data manager buffers, or the number of communication 
blocks. 

IPTAR 

1 

Automatic recovery flag: 


Value Description 

0 Automatic recovery is disabled. 


1 Automatic recovery is enabled. 
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If recovery is disabled, the following requests are not 
honored in recovery mode. 

Request Comments 

CALLRTN Transactions can be scheduled, but input is 

not logged to the communication recovery 
file (CRF). 

RERUN 

RGET 

RPUT 

RSECURE 

SECURE 

TINVOKE 

TSTAT Except for the keywords USER and NEXT. 

WSTAT Except for the keywords STEP ( = 8 or =9) 

and USER. 
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Parameter 

IPTST 

MAXJL 

MAXRA 

MAXTO 

MAXWS 

NCTL 


RECDF 

TLDL 


Default Description 

500 Number of terminals that can access TAF. IPTST must be 

greater than 0 and less than 4095. 

2500 Maximum word count on one journal request to any 

journal file, including header words; defined in deck TAF. 

500B Task limit for RA+1 requests; defined in deck TAF. 

6*MAXWS Maximum number of words a task can send to the 

communication subsystem. Reaching or exceeding this 
value causes the task to abort. 

409 + 1 Number of words SEND can transmit plus 1. Exceeding 

this value causes the task to abort. 

250 Maximum number of terminals in the network 

communication table (NCT). To reduce core storage 
requirements, NCTL may be less than the total number of 
terminals in the network file (each entry requires 3 CM 
words). NCTL should be greater than or equal to the 
maximum number of terminals logged in at one time. If 
NCTL is exceeded, a terminal is rejected upon login. If 
the number of terminals defined in the NCTFi file is less 
than NCTL, the number of terminals in NCTFi replaces 
the value specified by NCTL. 

NOTE _._ 

The installation parameter MAXRA must be equal to or 
greater than the value for NCTL for successful 
initialization of TAF. This is due to the processing that 
CTASK must complete for every user during initialization. 


0 Default user recovery flag: 

Value Description 

0 User recovery is enabled. 

1 User recovery is disabled. 

TLDLE*10 Amount of space to reserve for added tasks in the 

TAF-resident copy of the directory of each task library 
attached by TAF. This space can be used when TAF is 
informed of a task library change through the LIBTASK 
TT option. The value of the symbol should be a multiple 
of the size of a task library directory entry (TLDLE, 
currently 3). 

The default value allows space for 10 (TLDL/TLDLE) 
additional tasks. If more than TLDL/TLDLE tasks are 
added by the TT option, only the first TLDL/TLDLE tasks 
can be executed. The next time TAF is reinitialized, 
however, all the tasks added by using the TT option are 
available to be executed. TLDL is defined in deck 
COMKTLD. 
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Parameter 

Default 

Description 

TYPEAH 

0 

Enables or disables a user to type ahead in TAF. 


Value 

Description 

0 

Type-ahead is enabled. 

1 

Type-ahead is disabled. 


The following parameters are used with the TAF/CRM Data Manager and are defined 
in deck COMKIPR. 


Parameter 

Default 

AIBFL 

31 

AOBFL 

31 

BMAX 

8 

CMAXDB 

31 

CMDM 

31 


CMMBFL 70000B 

CMMEFL 0 

CMMTFL 30000B 

CRMUPM 15 

RMDM 1 


Description 
Input queue length. 

Output queue length. 

Number of before-image recovery files. The maximum 
value for BMAX is 63. 

Number of CRM databases. 

Maximum number of transactions concurrently issuing 
TAF/CRM Data Manager requests and the number of 
segments in each before-image recovery file belonging to 
TAF/CRM Data Manager. If you change this parameter, 
database recovery is not possible using existing 
before-image recovery files: you must recreate the 
before-image recovery files. 

Base field length in words for common memory manager 
(CMM) buffer management. 

Number of words for CMM to expand buffer management. 

The upperbound on CRM’s target field length. This area 
within the CMM buffer is used by CRM data and index 
blocks (for more information, refer to the CRM Advanced 
Access Methods Version 2 Reference Manual). 

Number of updates allowed. Also defines the number of 
records in each segment of the before-image recovery files. 

Number of mainframes running the TAF/CRM Data 
Manager. 
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The following parameters are used with TOTAL Data Manager and are defined in deck 
TAF. For information on the installation of TOTAL, refer to the NOS Version 2 
Applications Installation Handbook. 


Parameter 

Default 

Description 

TIMDM 

10 

Maximum number of transactions concurrently issuing 
TOTAL Data Manager requests. 

TMAXDB 

31 

Maximum number of TOTAL databases that can be 
initialized. 

TMAXFIL 

100 

Maximum number of files per database. 

The following parameter is defined in deck COMKNWC. 

Parameter 

Default 

Description 

MLIM 

100 

Maximum number of words in one SEND request before a 
task is rolled out pending completion of terminal output. 

Unless otherwise specified, the following parameters are defined in deck COMKIPR. 
These parameters specify the default communication block parameters. 

Parameter 

Default 

Description 

CBDL 

57 

Length of the data input area in the communication 
blocks. This parameter is in deck COMKCBD. 

CBUL 

9 

Length of user area in the communication blocks. This 
parameter is in deck COMKCBD. 

NCBC 

4 

Maximum number of communication blocks reserved for 
large transaction input. 

NLIN 

4 

Maximum number of users allowed to perform large 
transaction input simultaneously. TAF reserves n - NLIN 
* NCBC - RSCMB communication blocks for smaller 
transaction input, n is the number of communication 
blocks with which TAF is initialized. NLIN should not be 
less than 4. 

RSCMB 

2 

Maximum reserved communication blocks for nonterminal 
use. This number is included in the NCMB parameter. 
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The following parameters, defined in deck COMKTLD, specify the default task library 
parameters. 


Parameter 

Default 

Description 

TLDMN 

10 

Number of tasks that may be added online to TAF’s copy 
of any particular task library directory by the LIBTASK 
TT option. 

TLDMT 

600 

Maximum number of tasks allowed in a library. The 
maximum value for TLDMT is 1353. 

TRDMN 

10 

Number of transactions that may be added online to 
TAF’s copy of any particular transaction library directory 
by the LIBTASK TT option. 

TRDMT 

300 

Number of named transactions per library. 




The following parameters, defined in deck DMREC (except where otherwise indicated), 
specify the default batch recovery parameters. 


Parameter 

Default 

AAICL 

200 

CRMARB 

15 


CRMARFN 35000 


Description 

Number of ignore entries. 

Number of after-image records that are buffered in the 
CM buffer for the file before they are flushed to disk. 

Also, the block length for after-image recovery files 
(ARFs). If you change this parameter, you must dump and 
recreate all ARFs. This parameter is in deck COMKIPR. 

Length in physical record units (PRUs) of after-image 
recovery files. When preallocated by TAF or DMREC, the 
length specified by CRMARFN is assigned to the files 
excluding the header. This parameter is in deck 
COMKIPR. 


DTTP 1 Tape drive type definition for dumping database and 

after-image recovery files; defined in deck COMKIPR. 

Value Description 

0 7-track tapes 

1 9-track tapes 
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Parameter 

Default 

Description 

EXPCT 

10 

Default value of the percentage parameter for the 
EXPAND directive of deck DMREC. 

FTABL 

5000 

Length of intermediate ignore table used during DMREC 
recovery. 

NCOPY 

2 

Number of backup dumps to keep. 

NDUMP 

1008 

Number of dumps or directives. NDUMP must be less 
than 5008. 

NUMARF 

1 

Number of duplicate ARF copies. 

TDEN 

4 

Tape density for dumps; any of the following. 



Value Description 



1 556 cpi 



2 200 cpi 



3 800 cpi 



4 1600 cpi 



5 6250 cpi 



This parameter is in deck COMKIPR. 

TDTR 

2008 + 408* 

DTTP+ 

TDEN 

Tape format definition. 

TLOGL 

100 

Number of files in database. 

TTIGL 

5000 

Length of table that contains the transaction entries to be 
ignored during DMREC recovery. 

TVSNL 

40 

Number of VSNs allowed. 

WBUFL 

400 IB 

Length in words of buffer used to contain data read from 
a block on the after-image recovery file. Size depends on 
the installation parameters CRM ARB and CM DM, and on 
the maximum record length specified for the database 
files in the xxJ file (refer to the TAF Reference Manual).' 
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TCP/IP/FTP/TELNET 

The TCP/IP/TELNET portion of the software (that is, software that executes in the DI) 
is automatically installed as part of a CDCNET installation. 

File Transfer Protocol (FTP) consists of three NAM applications that provide file 
transfer capabilities between hosts on a TCP/IP network. FTP can be utilized only on 
a system connected to a CDCNET network that has access to a configured TCP/IP 
gateway. 

The NAM applications are built as two separate binaries: FTP and FTPS. The FTPS 
binary has two entry points: FTPI (client mode server) and FTPS (server mode 
server). FTP is invoked by the NOS user to initiate a file transfer session. The FTPI 
and FTPS applications are started by NAM as part of the network startup. 

Subsequent copies of the FTPI and FTPS applications are started by NAM based on a 
user request. 

This section describes the following: 

• Unique Parameters 

• Host Name and Address Definition for TCP/IP Network 

• NAM Startup Procedure File Changes 

• FTP Network Host Application Program Requirements 

• Network Definition Language (NDL) Requirements 

Unique Parameters 

Parameter Description 

DEBUG To add code to aid in debugging and maintenance, specify the 

keyword DEBUG on the call to the TCPH installation procedure. 

NOTRACE To not create the trace and log files, specify the keyword 

NOTRACE on the call to the TCPH installation procedure. 


Host Name and Address Definition for TCP/IP Network 

You must create an ASCII (6/12) file called TCPHOST that contains mappings between 
the Internet addresses and the names and aliases for hosts on the network. The 
TCPHOST file must be public and can be either indirect or direct access. TCPHOST 
must be resident under the user name specified by the NETUN2 parameter. The 
released default for NETUN2 is NETADMN. 

Entry format: 

1nternet_address system_name [ LOCALHOST_mi ] [ [alias] ... ] # Optional Comment 
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Parameter 
inter net_ address 


system_name 


LOC ALH OST_ mi 


alias 


Description 

The Internet Protocol (IP) address of the host in dotted 
decimal format. Refer to the CDCNET Configuration and 
Site Administration Guide. 

The name of the host associated with the IP address. It 
must be unique across the network. It can be any string up 
to 31 characters. The first character must be alphabetic. 
Uppercase and lowercase characters are considered 
equivalent. Embedded blanks are not permitted. 

An alias that identifies the NOS host, mi is the NOS 
machine id. This alias identifies the entry for the NOS host 
on which FTP executes. The host uses this entry to 
determine its IP address. If more than one NOS host shares 
the permanent file base where the TCPHOST file resides, a 
LOCALHOST_mi entry is required for each host that has 
access to the TCP/IP network. 

An alternate name for the host. Typically, it would be a 
shorter name. More than one alias for a given host is 
permitted. An alias need not be unique across the network, 
however, an alias must be unique in each host file, since 
the mapping of an alias to an IP address applies to the first 
match found in the file. 


# Indicates the beginning of a comment. 

The following example shows a possible TCPHOST file: 


tt 

a Host file for hosts S05 and S04 

tt 


192.5.209.100 

BDI_F_V 


192.5.209.101 

CYBER_S0 


192.5.209.102 

S05 s05 

local host_05 

192.5.209.103 

V05 v05 


192.5.209.104 

S04 s04 

local host_04 

192.5.209.105 

V04 v04 


192.5.209.120 

SVLBDIS 


192.5.209.121 

SVLBDIU 


192.5.209.122 

SOI SOI 


192.5.209.123 

V01 vOI 


192.5.209.124 

S02 sQ2 


192.5.209.125 

V02 V02 


192.5.209.126 

M07 m07 


192.5.209.127 

S03 s03 


192.5.209.130 

AN02 


192.5.209.131 

AV02 


192.5.209.53 

MERCURY 

VAX_e vax 

192.5.209.54 

COMPAQ 


192.5.209.55 

ICARUS SUN 

192.5.209.57 

IRIS C910 

192.5.209.58 

CLOVER 



tt BDI_E - FTP/VE BDI 
K C930 S/N 106 SVL 
tt C835 s/n 102 NOS 
tt C835 s/n 102 NOS/VE 
tt C830 s/n 902 NOS 
tt C830 s/n 902 NOS/VE 
if SVL CLSH SERVER DI 
if SVL CLSH USER DI 
H C855 s/n 125 NOS 
if C855 s/n 125 NOS/VE 
a C855 s/n 106 NOS 
tt C855 s/n 106 NOS/VE 
tt C875 s/n 907 NOS (ARH) 
tt C760 S/N 407 
it C990 S/N 102 NOS (ARH) 
it C990 S/N 102 NOS/VE (ARH) 
it VAX 11/750 
tt COMPAQ 
# SUN 

tt CYBER 910 / SILICON GRAPHICS 
it CYBER 910 / SILICON GRAPHICS 
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NAM Startup Procedure File Changes 

FTP applications use the same NAMI job startup procedures as does NAM, with the 
following additions to NAMSTRT: 


• Application startup calls in the network startup records. 


Call 

Description 

JOB(JOBFTPI,IP,SY,NS) 

File Transfer Protocol Interpreter/Server (FTPI) - 
Normal Job 

JOB(JOBFTIR,PI,DI,SY,NS) 

File Transfer Protocol Interpreter/Server (FTPI) - 
Restart Job 

J OB(J OBFTPS,ST,SY,NS) 

File Transfer Protocol Server (FTPS) - Normal 
Job 

JOB(JOBFTSR,TS,DI,SY,NS) 

File Transfer Protocol Server (FTPS) - Restart 
Job 

• Parameters for the standard 

NAM startup records: 

Call 

Description 

PARAM(PISTART = YES) 

Start the initial copy of the client mode FTP File 
Server (FTPI) when NAM comes up. 

PARAM(TSSTART - YES) 

Start the initial copy of the server mode FTP 

File Server (FTPS) when NAM comes up. 

NOTE 



A NO value for either of the above parameters inhibits starting of the corresponding 
FTP data transfer application. If FTPI is not started, FTP client mode access from 
the CYBER host to the FTP server on other TCP/IP hosts in the network is 
unavailable. If FTPS is not started, FTP server mode access from other TCP/IP hosts 
in the network to the CYBER host is unavailable. 


FTP Network Host Application Program Requirements 

Job skeleton records for the FTPI and FTPS jobs must contain a command that calls 
the program the job intends to run. These commands have the following format: 

proglparameterl,....parametern) 

Field Description 

prog Program call. May be FTPI or FTPS. 

parameter! Unless specified otherwise, these are optional, order-independent 

parameters. They may be of the form: 

keyword = value 

The files used by each program are listed following the description of each program 
call. 
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FTPI - File Transfer Protocol Interpreter/Server 
FTPI requires the following command; 

FTPI(NIN=n1n,MC=mc,TCPHUN=t cphun) 


Parameter 

Description 

MC = mc 

Maximum message count; specifies the maximum number of 
messages to be accumulated in the debug log file before 

NETREL is called. No NETREL call is issued if MC = 0. The 
default value, which is 500, may be reset using the ZZMC 

PARAM statement. 

NIN = nin 

Network invocation number. One- to three-digit decimal number 
assigned by NAM when the network operation is started. This 
parameter is required. It is used to create trace file names. 

TCPHUN = tcphun 

The user name where the TCPHOST file resides. This 
parameter is required. 

FTPI requires the 

following files: 

File 

Description 

ZZZZZN1 

The job record to be copied to the ZZZZZDN file by NETREL. 

This job record determines the disposition of the network trace 
file when NETREL is called on a periodic basis. 

ZZZZZN2 

The job record to be copied to the ZZZZZDN file by NETREL. 

This job record determines the disposition of the network trace 
file when NETREL is called as a result of an operator command. 

NOTE 


The default job skeleton of FTPI creates ZZZZZN1 and ZZZZZN2 from the input 
records of the FTPI job. 

FTPS • File Transfer Protocol Server 

FTPS requires the following command: 

FTPS(NIN=nin,MC 

=mc,TCPHUN=tcphun) 

Parameter 

Description 

MC = mc 

Maximum message count; specifies the maximum number of 
messages to be accumulated in the debug log file before 

NETREL is called. No NETREL call is issued if MC = 0. The 
default value, which is 500, may be reset using the ZZMC 

PARAM statement. 


7-206 NOS Version 2 Installation Handbook 


Revision L 





TCP/IP/FTP/TELNET 


Parameter 

Description 

NIN = nin 

Network invocation number. One- to three-digit decimal number 
assigned by NAM when the network operation is started. This 
parameter is required. It is used to create trace file names. 

TCPHUN = tcphun 

The username where the TCPHOST file resides. This parameter 
is required. 

FTPS requires the following files: 

File 

Description 

ZZZZZN1 and 
ZZZZZN2 

Described under FTPI, earlier in this section. 

NOTE 


The default job skeleton of FTPS creates ZZZZZN1 and ZZZZZN2 from the input 
records of the FTPS job. 


Network Definition Language (NDL) Requirements 

To use FTP with CDCNET, you must modify the Local Configuration File (LCF) to 
include application definition (APPL) statements and OUTCALL statements. The APPL 
statements define the NAM applications required to support FTP, and the OUTCALL 
statements define the path used by the FTP applications to access the CDCNET TCP/IP 
gateway. The released NDL file, NDLDATA, on the network administration user name 
contains the required statements. They are as follows: 

LCFFILE :LFILE. 

FTP :APPL, MXCOPYS = 15. 

FTPI :APPL, MXCOPYS = 15, PRIV. 

FTPS :APPL, MXCOPYS = 15, PRIV. 

*** OUTCALL BLOCK TO ACCESS TCP/IP GATEWAY 
* 

* REPLACE THE TEXT SURROUNDED BY POUND SIGNS (FOR EXAMPLE, #DN#) 

* BELOW WITH THE MACHINE ID FOR THE NOS HOST, THE NODE NUMBERS 

* FOR THE MDI USED TO ACCESS CDCNET, AND THE CYBER HOST MODEL AND 

* SERIAL NUMBER. REMOVE THE ASTERISK FROM COLUMN ONE TO ACTIVATE 

* THE OUTCALL FOR FTP/NOS. 

* 

* IF MULTIPLE CYBER HOSTS ARE SHARING THE PERMANENT FILES WHERE 

* THE TCPHOST FILE RESIDES, AN OUTCALL ENTRY IS REQUIRED FOR 

* EACH HOST THAT HAS ACCESS TO THE TCP/IP NETWORK. 

* OUTCALL NAME 1 = TCPIPGW, NAME2 = H#m #, SNODE = #SU#, DNODE = #DN#, 

* NETOSD = DDV, ABL = 7, DBL = 7, DBZ « 2000, UBL = 7, 

* UBZ = 18, SERVICE = GW_TCPIP_tfMMMtf_*SSS#. 

END. 
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Parameter 

Description 

#DN# 

The destination node is the decimal value of the NT parameter 
on the MDI’s EQPDECK entry. Refer to the example below. 

#MI# 

The NOS machine id is the two alphanumeric characters from 
the MID CMRDECK entry. 

#MMM# 

The CYBER model number (leading zeroes removed). For 
example, if your mainframe is a 180-810, 810 would be specified 
for this parameter. 

#SN# 

The source node is the decimal value of the ND parameter on the 
MDI’s EQPDECK entry. It is channel-connected to the NOS host 
#MI# and has access to the CDCNET containing the TCP/IP 
gateway. Refer to the example below. 

#SSS# 

The CYBER serial number (leading zeroes removed). For 
example, if your CYBER serial number is 002, only the 2 would 
be specified for this parameter. 


This example shows the relationship between the EQPDECK entry and the OUTCALL 
parameters. If the EQPDECK entry is as follows: 


EQ033=ND,ST=ON,EQ=00,PI=1,CH=27,ND=45,NT=65. 

The #SN# parameter would be 37, and the #DN# parameter would be 53. 

For more information, refer to the Network Definition Language Reference Manual 
and the CDCNET Configuration and Site Administration Guide. 
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TERMLIB • Terminal Library 

TERMLIB creates the permanent files TERMLIB and TDUFILE and places terminal 
capsules (termcaps) which the site has chosen to be resident termcaps into SFLIB and 
QSFLIB. 

This section describes the unique parameters in TERMLIB and gives an example of 
how to call this procedure. 

Unique Parameters 

Parameter Description 

TERMCAP This parameter allows you to specify which terminal capsules will be 
resident. The default is no terminal capsules are declared resident. 

NOTE 


To make a terminal capsule resident, you must modify the common deck COMCGTO 
to match the capsules specified with the TERMCAP parameter. 


Example: 

The following installation procedure call to TERMLIB changes the default resident 
terminal capsule from none to Z721, Z722, and ZVT100: 

BEGIN,TERMLIB,INSTALL,TERMCAP=$Z721,Z722,ZVT100$ 
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TEXT and TEXTIO - Product TEXTS and Product 
TEXTS I/O 

This section describes these installation options for TEXT and TEXTIO: 

• Default IPARAMS 

• Unique Parameters 

• Installation Parameters 

• MFT Parameter Details 

• Installation Procedure Messages 

Default IPARAMS 

General installation parameters related to the common products are defined within the 
common deck IPARAMS, which is included in product TEXT. 

The default values of the IPARAMS configuration parameters are defined with the 
CEQU or CMICRO macros so that you can insert all modifications at one place. The 
CEQU and CMICRO macros define symbols conditionally; that is, they are effective 
only if the variables have not been previously defined. Therefore, any modifications 
you make must precede them. Insert all changes to IPARAMS at IPARAMS. 15. 

Modifications to be applied to products TEXT and TEXTIO should be applied only in 
the procedure TEXT. 

To obtain a listing of all installation parameters in IPARAMS as well as the micros 
set by the unique parameters, run a job similar to the following: 

job command. 

USER,insun,password. 

BEGIN,PRDIN,INSTALL,PRDNAME=TEXT,DISK=0. 

UPDATE,Q. 

COMPASS,A,I,S=0. 

GTR,INSTALL,Z1.PROC/TEXT 
COPYSBF.Z1,OUTPUT. 

—eoi— 

•COMPILE IPTEXT 
—eoi — 

The CSET, ECS, and MFT unique parameters also set micros and eliminate the need 
to create a USER file for several of the micros. Refer to the TEXT installation 
procedure in DECKOPL for more information. 
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Unique Parameters 

Parameter Description 

CSET Defines the character set to be used throughout the system. The 

character set selected determines the collating sequence to be used; that 
is, the order in which records are retrieved from a database and the 
results of comparisons of characters on a basis of greater than or less 
than. Refer to the CYBER Record Manager Basic Access Methods 
Reference Manual for a description of the collating sequences. The 
default value is C64. Here are the allowable values: 

V alue Description 

A63 Selects the ASCII graphic 63 character set. 

A64 Selects the ASCII graphic 64 character set. 

C63 Selects the CDC graphic 63 character set. 

C64 Selects the CDC graphic 64 character set. 


This parameter sets the IP.CSET symbol; the following reference 
IP.CSET: 


AAM 2 
APL 2 
BASIC 3 


COBOL 5 
COMPASS 3 
FCL 1 


FCL 2 
FCL 5 

FORTRAN 5 


Query Update 3 
Update 1 

8-Bit Subroutines 1 
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Parameter 

Description 

ECS 

This parameter specifies whether extended memory is available for use 
by LOADER. Allowable values are YES and NO. The default is YES 
since no negative impacts result if extended memory is not available. If 
you specify YES, extended memory is available for use by LOADER 
when loading user programs; if you specify NO, user programs loaded 
by LOADER cannot use extended memory. Note that extended memory 
is available only if UEC is defined by the EQPDECK XM entry during 
deadstart. (Refer to the NOS Version 2 Analysis Handbook for 
information about EQPDECK entries.) This parameter sets the 

IP.MECS symbol. 

MFT 

This parameter selects the mainframe model type. All values of the 
model micro are supported. The default is for the CYBER 74. Here are 
the allowable values: 


71, 72, 73, 74, 76, 171, 172, 173, 174, 175, 176, 720, 730, 740, 750, 

760, 810, 815, 825, 830, 835, 840, 845, 850, 855, 860, 865, 870, 875, 

960, 990, 994, or 995. This parameter sets the MODEL, HF.LIST, and 
IP.CMU symbols; most common products reference the MODEL micro. 
For more information, refer to MFT Parameter Details, later in this 
section. 

NOTE 



Do not add user code to set the symbols HF.LIST, IP.CMU, IP.CSET, IP.MECS, and 
MODEL, since they are set by the above parameters. 


Installation Parameters 

There is only one installation-changeable symbol in IPARAMS. 

Parameter Default Description 

OS.ID NOS x.x.x System identification micro for displaying the operating 

system name and version number in generated program 
binaries (for example NOS 2.5.2). Most common products 
reference the OS.ID micro. 
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MFT Parameter Details 

The HF.LIST, IP.CMU, and MODEL micros are set by the MFT parameter. To 
determine the relationship between MFT and these micros, consult a listing of the 
TEXT installation procedure in DECKOPL. To specify your own values for HF.LIST, 
IP.CMU, and the MODEL micro, specify MFT = 0 and apply user code to set these 
symbols. 


Parameter Description 

IP.CMU If a value other than zero is specified, the compare/move unit 

hardware is present. If you specify zero, the compare/move unit 
hardware is not present. COBOL 5 references IP.CMU. 

MODEL This parameter selects the mainframe model type. All values of the 

MODEL micro are supported. The default is for the CYBER 74. Here 
are the allowable values: 

71, 72, 73, 74, 76, 171, 172, 173, 174, 175, 176, 720, 730, 740, 750, 

760, 810, 815, 825, 830, 835, 840, 845, 850, 855, 860, 865, 870, 875, 

960, 990, 994, or 995. This parameter sets the MODEL symbol. Most 
common products reference the MODEL micro. 

HF.LIST Micro whose value specifies the presence of certain hardware features 

in the configuration on which the products are being used. HF.LIST is 
set in addition to the MODEL micro, since use of various hardware 
features by the products is conditional on HF.LIST. HF.LIST controls 
the following: 

Entry Description 

C Compare/move unit (CMU) hardware is present. 

L For models 76 and 176, LCME is present. 

For models 810, 815, 825, 830, 835, 840, 845, 850, 855, 860, 
865, 870, 875, 960, 990, 994, and 995, UEM is present 
only if defined during deadstart. 

Both LCME and UEM are kinds of memory for which direct 
access instructions (014 and 015) are defined. 

Sn Stack size; n specifies the size of the longest possible 

instruction stack program loop in words. If the mainframe 
being described has no stack, omit this entry, n can be one 
of the following. 

7 

74 and 6600 
10 

76, 175, 176, 740, 750, 760, 865, and 875 
48 

990, 994, 995 
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Parameter Description 

HF.LIST (continued) 

Entry Description 

ES Centra] processor exits a block copy sequentially into the next 

parcel of the current instruction word if no errors occur. 

Model 76 only. 

Px Type of central processor; x can be one of the following 

values. 

S 

6200, 6400, 6500, 71, 72, 73, 171, 172, 173, 174, 720, 730, 
810, 815, 825, 830, 835, 840, 845, 850, 855, 860, 870, and 
960; serial type CPU, etc. 

74 

6600, 6700, and 74 

76 

76 

175 

175, 740, 750, and 760 

176 
176 

740 

740, 175, 750, and 760 
750 

750, 175, 740, and 760 
760 

760, 175, 740, and 750 
865 

865, 875 
875 

875, 865 

990 

990, 994, 995 

994 

994, 990, 995 

995 

995, 990, 994 
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Parameter Description 

HF.LIST (continued) 


Entry Description 

The processor type defaults to PS if HF.LIST is defined but 
the processor type is omitted. 

PSD The central processor’s exchange package contains a PSD 

register (models 76 and 176 only). 

CRW Central memory read/write operations are performed for 

660/670 instructions; models 810, 815, 825, 830, 835, 840, 845, 
850, 855, 860, 865, 870, 875, 960, 990, 994, or 995. 

Here are the default values selected for the HF.LIST parameter as set by the unique 
parameter MFT on the call to the TEXT installation procedure: 


MODEL HF.LIST 

Micro Value Default String 


71 

72 

73 

74 
76 

171 

172 

173 

174 

175 

176 
720 
730 
740 
750 
760 
810 
815 
825 
830 
835 
840 
845 
850 
855 
860 
865 
870 
875 
960 
990 

994 

995 

Any other 


PS 

C,PS 

C,PS 

P74,S7 

P76,S10,L,ES,PSD 

PS 

C,PS 

C,PS 

C,PS 

P175.S10 

P176,S10,L,PSD 

C,PS 

C,PS 

P740.S10 

P750.S10 

P760.S10 

C,PS,CRW,L 

C,PS,CRW,L 

C,PS,CRW,L 

C,PS,CRW,L 

PS,CRW,L 

PS,CRW,L 

PS,CRW,L 

PS,CRW,L 

PS,CRW,L 

PS,CRW,L 

P865,S10,CRW,L 

PS,CRW,L 

P875,S10,CRW,L 

PS, CRW, L 

P990,S48,CRW,L 

P994,S48,CRW,L 

P995,S48,CRW,L 

PS 
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Duplicate parameter entries (such as two Px entries) are not allowed. 

When defining HF.LIST for products intended to be run on more than one mainframe, 
you can use the central processor type PS, P74, or P175 and include stack size (even 
if some of the mainframes do not have a stack). You must not include C and L 
unless those features exist on all of the mainframes in the configuration. The 
resulting products do not necessarily perform optimally on any one of the 
mainframes, but they perform better on a parallel processor (such as a 175) if that 
processor type is set in HF.LIST. 

Installation Procedure Messages 

The DECKOPL installation procedure for TEXT contains an update error. The following 
message appears in the load map: 

0*»* YANK, SELYANK, OR YANKDECK IDENT 1EP NOT KNOWN »** 

The following message appears in the dayfile: 

1 NON-FATAL ERRORS. 

This condition is non-fatal and does not affect the generated binaries. The frequency of 
occurrence is relative to this product as released; any local code may change the 
frequency. 
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UPDATE (Common Memory Manager Version 1, CYBER 
Common Utilities, Update Version 1) 

The following Update features are available through assembly options. You can modify 
them by deleting the appropriate entry in the range UPDATE.703 through 
UPDATE.711. An attempt to use these features when the option is not assembled 
causes Update to issue error messages. For example, when PMODKEY is not set, the 
PULLMOD statement is not recognized as a legal directive. 


Parameter Default 

AUDITKEY Enabled 

CHAR64 Enabled 

DECLKEY Enabled 

DYNAMFL Enabled 


EDITKEY Enabled 

EXTOVLP Enabled 

OLDPLKEY Enabled 

PMODKEY Enabled 


Description 
Allows audit functions. 

Declares 64-character set Update program library output. 
Enables DECLARE directive. 

Declares dynamic table expansion. When this option is 
assembled, Update automatically expands tables as 
required and dynamically requests NOS to change the 
user field length to accommodate the additional table 
area. At the end of the run, the field length is reduced to 
that requested by the user. 

Allows merge and edit functions. 

Enables detection of four types of overlap involving two or 
more cards in a correction set. 

Enables Update to read both old-style and new-style old 
program libraries. 

Enables PULLMOD statement and G option. 
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UPDATE (Common Memory Manager Version 1, CYBER Common Utilities, Update Version 1) 


The Common Memory Manager (CMM) uses symbol definitions from common deck 
CMMCOM. The symbols defined in IPTEXT that specify the operating system are also 
used. You can change the following CMMCOM installation parameters for CMM. 


Parameter Default 

DEFVER 0 


FLF 2000B 


FLINC 2000B 


Description 

Defines which of two versions of CMM is to be used by 
default. 

Value Parameter 

0 A version without error checking (FAST) is 

used. 

1 An error checking version (SAFE) is used. 

When variable block code is not present (only fixed blocks 
exist), this value is used as a default by the field length 
reduction algorithm. The amount of free space above the 
highest fixed block is reduced to FLF central memory 
words. 

When field length is increased by CMM, this value is 
used as a default increase above the minimum amount 
needed. 
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Introduction 

This chapter describes the SYSGEN installation command in the following sections: 

• Calling SYSGEN 

• Loading Permanent Files 

• SYSGEN Functions 

• SYSGEN Maintenance 

• SYSGEN Validations 
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Calling SYSGEN 

SYSGEN functions may be executed from DSD, DIS, an interactive terminal, or a batch 
job. The method used for calling SYSGEN determines how SYSGEN will load the files. 

• To call SYSGEN from DSD, use this command format: 

X.SYSGEN(function,params) 

SYSGEN loads any permanent files directly to the user name where the files are 
supposed to reside. To do this, you must have correct validations. Consult SYSGEN 
Validations later in this chapter for complete information. 

• To call SYSGEN from DIS, use this command format: 

USER(username,password) -OR- SUI(user index) 

SYSGEN(function,params) SYSGEN(functIon,params) 

SYSGEN loads any permanent files directly to the user name/index you have 
specified, unless the user name/index is UN = SYSTEMX (UI = 377777B). When 
SYSGEN is initiated from user name SYSTEMX, USER commands are executed and 
files are installed in the same manner as when SYSGEN is called from DSD. If 
SYSGEN is not started from user name SYSTEMX, USER commands are not 
executed. This will install the same as when SYSGEN is called from an interactive 
or batch job. 

• To call SYSGEN from an interactive terminal or from within a batch job, use this 
command format: 

SYSGEN(functIon,params) 

SYSGEN loads any permanent files directly to the user name under which the 
interactive or batch job is running. 


Loading Permanent Files 

This section documents the SYSGEN functions that load one or more permanent files 
from the permanent file tapes: 

• Loading the RECLAIM database 

• Loading , the files 

If you have not deadstarted your new system, you will need to load the RECLAIM 
database. 
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Loading the RECLAIM Database 

SYSGEN(INIT) is used to put the database on disk for upgrade orders and 
SYSGEN (UPGRADE) is used for component orders. Both functions may be executed 
from either an interactive terminal or from DIS at the system console. 

• To install an upgrade order: 

1. Mount the released deadstart tape on an available unit. 

2. To load files from an interactive terminal, log in to the installation user name 
to set up the RECLAIM database. To load files from DIS at the system console, 
first do a USER or SUI command to the installation user name. 

3. Enter the following commands: 

REQUEST,TAPE,VSN=vsn,D=dens1ty,LB=KU,F=I,PO=R. 

COPYE I,TAPE,SYSTEM,V. 

UNLOAD,TAPE. 

BEGIN,SYSGEN,SYSTEM,INIT,UPGRADE. 


Replace vsn with the VSN of the released deadstart tape (contained in the media 
number field of the external tape label). Replace density with the tape density of the 
tape (HY, HD, PE, or GE). 

The BEGIN call invokes SYSGEN(INIT), which loads the RECLAIM database from the 
deadstart tape and stores it on the user name under which the commands were 
executed. This also places a copy of the SYSGEN procedure on this user name and the 
user library PFGLIB in file PRODUCT, which allows the SYSGEN procedures from the 
new release tape to be used in multiple terminal sessions and from multiple user 
names. Binaries of NDLP, NETFM, and other utilities are placed in GLOBLIB to 
facilitate easier upgrades. Any RECLDB file that you may have had before the BEGIN 
command was executed will be replaced. 

Once INIT has completed, you may immediately execute the SYSGEN functions 
described in Loading the Files later in this section. However, if you wish to use 
SYSGEN during multiple terminal sessions or from user names other than the 
installation user name, you must do the following before executing the SYSGEN 
command: 

GET,SYSGEN/UN=1nsun. 

This gets the newly released version of SYSGEN, which in turn gets the newly 
released PFGLIB from file PRODUCT. This is also on the installation user name. 
(PFGLIB contains all SYSGEN procedures.) 

NOTE _ 

Do not initiate SYSGEN from DSD using X.SYSGEN function calls until you have 
deadstarted your new system. If you initiate SYSGEN before deadstarting the new 
system, you will be using an old and possibly incompatible version of SYSGEN. 
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• To install a component order: 

1. Mount the released permanent file tape on an available tape unit. 

2. To load files from an interactive terminal, log in to the installation user name 
to set up the RECLAIM database. To load files from DIS at the system console, 
first do a USER command to the installation user name. 

NOTE 


Execute a USER command before executing SYSGEN(UPGRADE) from the 
system console. SYSGEN(UPGRADE) will not work correctly if a SUI command 
is used. 


3. Enter the following command: 

SYSGEN,UPGRADE,0,0,vsn,densit y. 

Replace vsn with the VSN of the first permanent file tape; replace density with 
the density of the tape. 

This command updates your RECLAIM database (or creates one) with 
information about files on the permanent file tapes. Once you set up the 
RECLAIM database on your installation user name, you may load files from it. 


Loading the Files 

When loading permanent files, you may install files directly to the appropriate user 
name, or you may load files to a different user name for examination or modification, 
then move them to the correct user name later. For example, you may load file 
NAMSTRT directly to the network operations user name or load it to the installation 
user name for modification, then move it to the network operations user name later. 
This is determined by how SYSGEN is called. Refer to Calling SYSGEN, earlier in 
this chapter. 

SYSGEN(xxxx) Functions 

Use the SYSGEN(xxxx) function to load each PFGxxxx file from the permanent file 
tape and install the contents of the file. Replace xxxx with the matching xxxx of the 
PFGxxxx permanent file group name (PFGxxxx names are listed in appendix B). The 
following example loads and installs the files in PFGDECK: 

SYSGEN(DECK) 
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SYSGEN(group) Functions 


Use SYSGEN(group) functions to load a group of individual PFGxxxx files all at one 
time. SYSGEN has the following groups: 

Group Description 

CDCNET Installs components of CDCNET. When executed interactively, this group 
does not install all the files; additional steps are required. Refer to the 
CDCNET section of chapter 7. 


LIBRARY 

NAMSTRT 

OTHER 

SITE 

SUBSYS 


Installs all required files for user name LIBRARY. 
Installs all products that update the NAMSTRT file. 
Miscellaneous products. 

Installs standard installation site tools. 

Installs all subsystem startup files (excludes NAMSTRT). 


Consult the SYSGEN procedures for exact details on which files belong with which 
groups. Note that there is some overlap, for example, PFGFSEl is used as part of 
SITE, SUBSYS, and LIBRARY. 


SYSGEN(FILES) 

Use this function to load permanent files from the permanent file tapes when installing 
an upgrade or component order. All files are loaded except those needed to build 
products from source and those that were deleted from the database (as described in 
chapters 3 and 4). Validation files are not created or changed. SYSGEN(FILES) calls 
the following group functions (explained earlier in this section): SITE, NAMSTRT, 
SUBSYS, LIBRARY, OTHER and CDCNET. 

SYSGEN(FILES) has one parameter called vsn. Replace vsn with the VSN listed in the 
media number field on the external tape label of the first permanent file tape. 
SYSGEN(FILES) may be executed from DSD or from DIS under username SYSTEMX. 
Refer to Calling SYSGEN, earlier in this chapter. 

SYSGEN (FULL) 

Use this function to load permanent files from the permanent file tapes during a 
first-time installation. Validation files are created and ZZSYSGU is placed on user 
name SYSTEMX (refer to SYSGEN Validations later in this chapter for more 
information). Next, the RECLAIM database is loaded to user name INSTALL and the 
SYSGEN(FILES) function is called. 

SYSGEN(FULL) has no parameters. SYSGEN(FULL) should be executed from DSD. 
Refer to Calling SYSGEN, earlier in this chapter. 
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SYSGEN(RECLAIM) 

Use this function to load one to five permanent files from the permanent file tapes. 
These files are left local to your job. The RECLAIM database must have been 
previously loaded to the installation user name for this function to work properly. (This 
is done automatically during the SYSGEN(PULL) and SYSGEN(SOURCE) functions.) 

SYSGEN(RECLAIM) has five optional parameters. Replace them with the one to five 
file names that you want loaded. SYSGEN(RECLAIM) should be executed only from 
DIS, an interactive terminal, or a batch job. Refer to Calling SYSGEN, earlier in this 
chapter. 

SYSGEN(SOURCE) 

Use this function to load the permanent files needed to perform a customized 
installation. If the RECLAIM database does not exist on the installation user name, it 
is loaded there. Other files loaded at this time include: DECKOPL, INSTALL, 
COMMOD, GDIR, CODEPL, DBUBIN, MISCPL, PSRRPT, USERBPS, and RECLAIM. 

SYSGEN(SOURCE) has one keyword parameter called CCP. Include this keyword if 
you want to start building CCP at the CCPVAR step (refer to the CCP section of 
chapter 7). SYSGEN(SOURCE) may be executed following any of the formats described 
in Calling SYSGEN, earlier in this chapter. 


SYSGEN Functions 

This section documents the SYSGEN functions not related to the loading of permanent 
files: 

• SYSGEN(COPYSYS) copies the running system to disk or tape. 

° SYSGEN(COPYTAP) makes a copy of the release tapes. 

• SYSGEN(DST) creates a new deadstart tape. 

• SYSGEN(MOVE) moves permanent files. 

• SYSGEN(SWAP) adds debug/trace/63-character set binaries to the deadstart tape. 

• SYSGEN(UPGRADE) installs component orders. 

SYSGEN(COPYSYS) 

This function copies a running system file to disk or tape. Use this format to call the 
function: 

X.SYSGEN(COPYSYS,est.type) 

Replace est with the EST ordinal of the device you want to copy to; replace type with 
either the word DISK for copying a running system to disk or a value for a tape 
density (HY, HD, PE, or GE). 

If you are copying to disk, the procedure executes the INSTALL command to create a 
disk deadstart file. If you are copying to tape, the procedure executes the ASSIGN 
command. Thus, you should mount the tape you are copying to before executing this 
function. 
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SYSGEN(COPYTAP) 

This function makes copies of the release materials: the deadstart tape, permanent file 
tapes, and CIP tape. To use this function, you need two tape drives. Use this format to 
call the function: 

X.SYSGEN(COPYTAP ,aaaaa t density,numpf,dst, c ip) 

Parameter Description 

aaaaa Specifies the first 5 characters of the VSN of the permanent file tape, 

cip Specifies whether to copy the CIP tape. Enter YES or NO. 

density Specifies the density of the release tapes. 

dst Specifies whether to copy the deadstart tape. Enter YES or NO. 

numpf Specifies the number of permanent file tapes to copy. Specify 0 if you do 

not want to copy any of the tapes. 

If you specify that permanent file tapes should be copied, the function writes new 
labels (identical to those of the original tapes) on numpf tapes. The function then 
requests the first original tape and the first new tape and begins copying. Mount the 
tapes when you are requested to do so. After the permanent file tapes are copied, the 
function copies the deadstart tape and then the CIP tape, if specified. 

When you use the SYSGEN(COPYTAP) command to make copies of the permanent file 
tapes, make sure that you copy the files to a tape that is the exact same length as the 
original release tape. However, even when you use same-length tapes, the position of a 
file can shift because tapes can vary in the number of usable feet. 

If for some reason the position of a file shifts on the tape, you may have problems 
extracting the files from the tape. When RECLAIM cannot find a file on the tape, it 
issues the following message: 

DUMP FILE MALFUNCTION - FILE NAME MISMATCH 

You can rebuild the database and correct the problem by executing these commands 
from the installation user name where the RECLAIM database is stored: 

ATT ACH(RECLDB/M=W) 

EVICT(RECLDB) 

RETURN(RECLDB) 

RECLAIM(Z,L=LIST)/LIST,UN=NS2psrin,TN=vsn,D=densi ty,xx. 

Replace psrin with the 3-digit PSR level of the NOS release; replace vsn with the 
volume serial number of the first permanent file tape; replace density with the tape 
density; replace xx with MT for a 7-track tape or NT for a 9-track tape. RECLAIM 
reads all the tapes and rebuilds the database. 
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SYSGEN(DST) 

This function creates a new deadstart tape. Use this function when you have made 
simple changes to your deadstart file. For example, you have added or replaced 
deadstart decks. If you want to create a new tape using the PRODUCT file, use the 
GENDST command (refer to GENDST in chapter 9). Use this format to call the 
function: 

SYSGEN(DST.old,Igo,new,input.density) 

Parameter Description 

density Tape density for any tapes to request. If you don’t specify a tape 

density, no tape requests are made and SYSGEN only deals with local 
files. 

input Name of a file containing directives for the LIBEDIT that SYSGEN 

performs. Specify 0 (zero) if you have no LIBEDIT directives. 

Igo Name of the file which contains the binaries to update file old. If lgo is 

not local, SYSGEN looks for a permanent file with that name. You can 
specify 0 (zero) if no binaries are to be used. 

new Name of file to receive the new deadstart file. If no file is assigned and 

the density parameter is specified, a tape request for VSN = NDT is 
made. This file can be a preassigned magnetic tape. 

old Name of the base deadstart file. This deadstart file should be local to 

your job or you should supply the density parameter so that SYSGEN 
can request a deadstart tape to use as the base. If a tape is requested, 
the VSN is ODT. This file can be a pre-assigned magnetic tape file. 

SYSGEN(MOVE) 

The SYSGEN(MOVE) function moves permanent files produced by installation jobs to 
other user names. The user names must be known to SYSGEN. Refer to SYSGEN 
Maintenance later in this chapter. You must execute SYSGEN(MOVE) from the system 
console. Use this format to call the function: 

X.SYSGEN(MOVE,pfn,un,ct,ac,m) 
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Parameter 

Description 

ac 

Specifies the alternate user CATLIST option. Enter Y to allow alternate 
users to CATLIST the file. Enter N to prevent alternate users from 
using CATLIST to list the file. The default is N. 

ct 

Specifies the permanent file category. Enter PU for public, PR for 
private, or S for semiprivate. The default is PR. 

m 

Assigns read permission to the installation user name. Enter PERMIT to 
assign read permission. The default is to not assign read permission. 

Use PERMIT only when ct is set to PR. 

pfn 

Name of the permanent file to be moved. The file must reside on the 
installation user name. This parameter is required. 

un 

User name to receive files. Valid user names and passwords are listed 
in table 8-1. This parameter is required. 


SYSGEN(SWAP) 

This function creates a new deadstart tape with the debug/trace versions of NAM and 
RBF or a 63-character set version of NIP5870. Use this format to call the function: 

X. SYSGEN (SWAP, densi ty, pi ,p2,p3) 


Parameter Description 

density Specifies the density of the new deadstart tape. 

pi Specify the products to be swapped. You can specify RBF, NAM, or NIP. 

Any number or combination of these three can be used. 

NOTE _ 

Be sure to keep a copy of the deadstart tape that contains the original binaries. 
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SYSGEN(UPGRADE) 

This function is used during a component order. If you are executing this function from 
the system console, you must do it from DIS. Use a USER command (not a SUI 
command) to go to the installation user name. SYSGEN (UPGRADE) performs two 
tasks: it updates the RECLAIM database to include information about the permanent 
file tapes and merges the component order binaries (if any) with a deadstart file. (It is 
possible to have SYSGEN(UPGRADE) only update the RECLAIM database and not 
have it merge any binaries.) The basic format for SYSGEN(UPGRADE) is: 

SYSGEN(UPGRADE.old,new,vsn,densit yl,densit y2) 

Parame ter Description ___ 

densityi Tape density of the permanent file tapes of the component order. 

density2 Tape density of both the old and new deadstart tapes. This parameter is 

optional. 

new Name of file to receive the merged binaries. 

old Name of file containing the binaries of the current system. 

vsn Volume serial number of the first permanent file tape of the component 

order. 

Depending on how the parameters are specified, old and new can be any combination of 
disk or tape files. If old is local and density2 is specified, the density2 parameter only 
affects file new. If old is local and density2 is not specified, new is a disk file. Old and 
new can also be pre-assigned tapes. If old is not local and density2 is specified, an old 
deadstart tape is requested with a VSN of ODT and the new deadstart tape is 
requested with a VSN of NDT. If old and new are both 0, only the RECLAIM database 
is updated; no binaries are merged. 

SYSGEN Maintenance 

The SYSGEN procedures are maintained in deck SYSGEN on DECKOPL. To create a 
new set of SYSGEN procedures, execute this command: 

BEGIN,SYSGEN,INSTALL.insun,netopun,netadun. 

Replace insun with your installation user name, netopun with your network operations 
user name, and netadun with your network administration user name. The defaults for 
these user names are INSTALL, NETOPS, and NETADMN respectively. 

The SYSGEN procedures consist of a NOS procedure SYSGEN and a user library 
PFGLIB on the deadstart file. The BEGIN command, shown previously, adds SYSGEN 
and PFGLIB to the PRODUCT and GLOBLIB files. (If GLOB LIB and PRODUCT are 
attached and a LIBRARY(GLOBLIB) has been done, all SYSGEN functions execute 
from PRODUCT and GLOBLIB.) 

If you need to modify SYSGEN (other than the user name parameters), you should 
append your modifications to file COMMOD. Then, run the SETUP procedure, using 
MOD = COMMOD, to create a new INSTALL procedure file. 
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SYSGEN Validations 

To install permanent files, SYSGEN must know the batch passwords of the user names 
listed in table 8-1. (Interactive passwords are not used by SYSGEN.) SYSGEN uses a 
procedure file named ZZSYSGU (indirect access file on user name SYSTEMX) that 
contains USER commands with passwords that match those stored in the system 
validation files. Initially, the passwords in ZZSYSGU match those listed in table 8-1. 
However, to maintain security, these passwords may be changed as often as needed 
without requiring any modifications to SYSGEN. 

If the VALIDUS and VALINDS files exist on your system prior to installation, you 
must load ZZSYSGU and either modify it to match your validations or modify your 
validation files to match those needed by SYSGEN. You can do so from the system 
console. Use one of the following commands. Before you begin, you must deadstart your 
new system. In addition, have the permanent file tapes available for mounting. 

• X.SYSGEN(LOADUSE). This command loads file ZZSYSGU as a private indirect 
access file on user name SYSTEMX. Use an available editor to modify the contents 
of the file to match your system’s validations. 

• X.SYSGEN(MODVAL,ADD). This command loads file ZZSYSGU and modifies the 
files VALIDUS and VALINDS to contain the user names and passwords listed in 
table 8-1. User names that you do not have are created. Passwords for existing 
SYSGEN user names are changed to match those in the table. Any user name not 
needed by SYSGEN is not changed. Note that this function sets the user index of 
user name KB100DC to the released default value of 16B. No other created user 
names are assigned a specific user index. 

If SYSGEN(FULL) created VALIDUS, VALINDS, and ZZSYSGU, you should alter the 
passwords upon completion of installation for security reasons. You can do so by first 
using the MODVAL command to change the system validation files (refer to the NOS 
Version 2 Administration Handbook). Next, use an available editor to modify file 
ZZSYSGU to match the changes you made to the validation files. 

Certain products are released with default user names and passwords. If these user 
names or passwords are changed, the products may need to be rebuilt. Refer to chapter 
7 for additional information. Products that could be affected are APL2, MAP, NSS, and 
TAF. 

If you wish to change the default Control Data user names to ones that are 
site-defined, modify file ZZSYSGU as follows. 

For example, to change user name INSTALL to user name INS700, alter the following 
line in file ZZSYSGU from 

.IF, ($P1$ .EQ. $INSTALL$) .$USER(INSTALL,INSTALL) 


to 


.IF, ($P1$ .EQ. SINSTALLS) .$USER(INS700,password) 

Only the USER portion should be changed. When SYSGEN finds a file that should be 
put on a specific user name, it keys off the PI parameter. The PI parameters must be 
the Control Data default values. When SYSGEN finds the matching value (in this 
example, INSTALL), it executes its USER statement. In this example, SYSGEN would 
put the file on user name INS700. 
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Table 8-1. 

SYSGEN User Names and Passwords 

User Name 

Batch Password 

Products Affected 

APLO 

APLO 

APL2 

APL1 

APL1 

APL2 

CDCCE 

CDCCE 

CML, MAP 

CDCCE2 

CDCCE2 

MAP 

INSTALL 1 

INSTALL 

CCP, CDCNET, CROSS, Dual State, FSE, MAP, 
NAM5, NOS 

KB100DC 

TAFPASS 

TAF 

LIBRARY 

LIBRARY 

DCL, FSE, NOS, XEDIT 

MANUALS 

MANUALS 

NOS and NOS Online Manuals 

NETADMN 1 

NETADMN 

CCP, CDCNET, NAM5 

NETOPS 1 

NETOPSX 

CDCNET, ITF, NAM5, PSU, PTF/QTF, RBF5, 
TCP/IP/FTP/TELNET 

NVE 

NVEX 

Dual State 

SSPOT 

STATION 

NSS 

SUBFAMO 

SUBFAMO 

MSE 

SYSTEMX 

SYSTEMX 

CDCS2, Dual State, FSE, IAF, MAP, MCS, MSE, 
NAM5, NOS, NSS, RHF, TAF 


1. These user names refer to the Control Data default values for the installation user 
name, network operations user name, and the network administration user name. The 
default values are INSTALL, NETOPS, and NETADMN, respectively. If you have 
changed these values, substitute your site names for the Control Data default values. 
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Introduction 

This chapter describes the following commands, parameters, and procedures used during 
installation: 

• COMMOD File Parameters 

• DECKLIS Procedure 

• Disk Installations 

• GENDST Procedure 

• MISCGET Procedure 

• REPORT Procedure 

• RESETP Procedure 

• SETUP Procedure 
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COMMOD File Parameters 

The installation procedures in DECKOPL contain two types of parameters: those that 
are unique to a specific installation procedure and those that are common to all 
installation procedures. 

DECKOPL is released with a default value set for all of the common parameters. 
These defaults are in a modification set file named COMMOD. When you use the 
SETUP procedure to apply the modification set in file COMMOD against DECKOPL, 
SETUP sets all the default parameters in the INSTALL procedure file. 

The COMMOD file is created automatically by the SYSGEN(SOURCE) function. Refer 
to SYSGEN(SOURCE) in chapter 8. 

NOTE _ 

The COMMOD file parameters you must change to perform a disk installation are 
described later in this chapter. 


If you want to change the values for any of these parameters, follow these steps: 

1. Edit the file COMMOD using an available editor. 

2. Change the parameter values for your site. 

3. Replace file COMMOD. 

4. Use the SETUP procedure to build a new INSTALL file from DECKOPL that 
contains your modifications to COMMOD. For example: 

BEGIN,SETUP,INSTALL,MOD=COMMOD,INSTALL. 

The following list describes the parameters in file COMMOD. 

Parameter Description 

CCPLIST Called from common deck COMCCPL. Used by CCP/CROSS 

installation procedures only (refer to chapter 7). 

D = option Called from common deck COMDEN. Specifies the tape density. 

The default value is PE. 


Value 

Description 

HY 

800 cpi (7-track). 

HD 

800 cpi (9-track). 

PE 

1600 cpi (9-track). 

GE 

6250 cpi (9-track). 

NOTE 


This parameter only affects tape requests for deadstart tape and 
density for output PLs when DISKINS=NO and OUTPRD = YES. 
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Parameter 

DISKINS 


IA 


ICHG 


IFAMILY 


Description 

Called from common deck COMDISK. Controls the type of 
installation. The default is DISKINS=NO. 

Value Description 

NO Magnetic tape installation. This option keeps as many 

files on tape as possible. Only the composite OPL and 
the CCP/CROSS permanent files are kept on disk. 

YES Disk installation; if you want to use auxiliary disk 

packs, additional parameters relating to disk pack 
name and type must be changed from the defaults. 
Refer to Disk Installations later in this chapter. 

Called from common deck COMIA. Specifies how an installation 
procedure is submitted for execution. The default is IA = NO. If 
you do not specify the keyword IA, the installation procedure 
submits a batch job for execution unless the installation 
procedure is already executing as a batch job. 

If the job origin type is not batch, you can specify the keyword 
IA to cause immediate execution of an installation procedure. 
Specifying IA also causes the following: 

• If the job origin type is interactive, the file OUTPUT is 
assigned to mass storage and at job completion or abnormal 
termination is renamed IAOUT. 

If you want to assign the output back to your terminal rather 
than mass storage, enter this command: 

ASSIGN,TT,OUTPUT. 

• If the job is running from DIS, the installation procedure runs 
from DIS and does not submit a batch job. 

• The installation procedure issues a LIBRARY,GLOBAL 
command when the job is finished executing. This causes the 
local file GLOBAL (if one exists) to be made the global 
library. This feature allows you to have your own global 
library named GLOBAL in effect at a terminal to run 
installation procedures and to have GLOBAL remain in effect 
after the installation procedures are completed. 

Called from common deck COMIUN. Specifies the valid charge 
and project number values for the installation user name. The 
default is an asterisk (*). Here is a sample value that causes the 
command CHARGE(1187,594N321) to be executed: 

*N=$1187,594N321S. 

This parameter is significant only if IUCHG=YES. 

Called from common deck COMIUN. Specifies the default value 
for the alternative family name. Set this value if you are not 
installing on the system default family. This parameter is 
significant only if IUCHG=YES. 
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| Parameter 
| IPW 

j IUCHG 


IUN 

LIST=filename 

MAPTYPE 


NOECS 

NOPURGE 


Description 

Called from common deck COMIUN. Specifies the password for 
IUN (installation user name). The default password is 
INSTALL. The password is used by SUBPROC. This parameter 
is significant only if IUCHG=YES. 

Called from common deck COMIUN. Controls the source of 
USER and CHARGE commands for batch job submittal. The 
default value is YES. 

Value Description 

NO You must create a USERCHG file (containing 

appropriate USER, CHARGE, RESOURC, and 
PACKNAM commands) for the installation 
procedures. The file can be local, direct, or indirect. 

YES The parameter values specified by IUN, ICHG, 

IFAMILY, IPW, RESOUR, and PCKNAM are used to 
generate a USERCHG file. 

Called from common deck COMIUN. Specifies the installation 
user name. The default installation user name is INSTALL. 

This parameter is significant only if IUCHG=YES. 

Called from common deck COMLIST. Specifies the file for 
assembly or compilation listing output. The default is LIST=0. 

If filename is OUTPUT, the listing is printed with the 
installation procedure listing. If you specify any other filename, 
use the TOLIST parameter to specify the destination for the 
output file. Also, the file cannot be a magnetic tape file if the 
installation procedure uses the FORTRAN compiler. 

Called from common deck COMLIST. Specifies the type of load 
map generated by the installation procedure. The default value 
is FULL. 


Value 

Description 

OFF 

No map is generated. 

PART 

Statistics and block map. 

ON 

Statistics, block map, and entry point cross 
references. 

FULL 

Statistics, block map, entry point cross references, 
and entry point map. 


Called from common deck COMNECS. Used by CCP/CROSS 
installation procedures only (refer to chapter 7). 

Called from common deck COMNOPG. Used by CCP/CROSS 
installation procedures only (refer to chapter 7). 
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Parameter 

OUTPRD 


PCKNAM 


PFGPN 


PFGPR 


PSRIN 


Revision L 


Description 


Called from common deck COMDISK. Controls the production of 
output program libraries in installation procedures. The default is 
N °. 

Value 

Description 

NO 

Output program libraries are not generated or 
written. 

YES 

The installation procedures write output program 
libraries. This does not apply to MODOPL. If 

OUTPRD = YES and DISKINS = NO, output program 
libraries are written to a RECLAIM dump tape with | 
VSN = OUTPLS. All output program libraries are 
written to this tape (or multiple tapes with this VSN)| 

NOTE 



If you do not apply user code to change program library common 
decks for those products also used as auxiliary PLs and you do 
not want to write output PLs, you can use the following 
parameter settings: 

OUTPRD=NO 

PSRIN=nnn 

PSROUT=nnn 

nnn defaults to the current release level. The input PLs are then 
used as auxiliary PLs and no product output files are written. 
Binaries are still stored in file PRODUCT. The released 
DECKOPL has the parameters set in this manner. 


Called from common deck COMIUN. Specifies the pack name and 
type if all files used in the installation process are to reside on 
an auxiliary disk pack. The entry format is 
(*N = $PACKNAM,pname/R = typr.$). The default is an asterisk 
(*). This parameter is significant only if IUCHG = YES. 

Called from common deck COMPFG. Specifies the auxiliary pack 
name where PFGxxxx files are written. The default option is to 
write these files to the catalog under which the installation 
procedure is executing. 

Called from common deck COMPFG. Specifies the auxiliary pack 
type where PFGxxxx files are written when the files are to reside 
on an auxiliary pack. 

Called from common deck COMIN. Specifies the 3-digit number 
identifying the PSR level of this release. The default is the 
current release level. 
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| Parameter 
1 PSROUT 


I RESOUR 


TOBLD = option 


| TOLIST=option 


Description 

Called from common deck COMOUT. Specifies the 3-digit number 
identifying the PSR level which is appended to the requested file 
name for the output PL files. The default is the current release 
level. If you do not change this value and OUTPRD=YES, the 
output PLs overwrite the input PLs. 

Called from common deck COMIUN. Specifies the format of the 
RESOURC command to use; for example: 

*N=$RES0URC(DJ=1,GE=1)$ 

This parameter is significant only if IUCHG=YES. 

Called from common deck COMTOB. Specifies the build listing 
disposition and determines whether the job output goes to the 
wait queue. The default is TOBLD = PRINT. 

Value Description 

PRINT Job output is printed at the central site. 

WAIT Job output (everything on file OUTPUT) is placed in 

the wait queue with a user job name of the same 
name as the installation procedure name followed by 
a B or an F. (If the procedure name is seven 
characters, the last letter of the name is replaced by 
the B or F.) If the job passed, the last letter of the 
output file name is B; if the job failed, the last letter 
of the output file name is F. 

Called from common deck COMTOL. Specifies the assembly list 
file routing and whether the file specified by the LIST parameter 
goes to the wait queue. The default is TOLIST=NONE; if the job 
fails, the list file is discarded. 

Value Description 

NONE The list file, if defined, is local to the job and is 

discarded when the job terminates. 

WAIT The file named in the LIST = filename parameter is 

routed to the wait queue; the user job name is the 
same as the installation procedure name, followed by 
the letter L (for example, AAM2L). If the procedure 
name is 7 characters, the last character is replaced 
by L. 

NOTE 


When you route listings to the wait queue, these files are 
counted in the total number of jobs validated for your user name. 
Also, if you want to specify different options for the LIST, 
TOBLD, and TOLIST functions, you can recode the procedures 
named JOBPASS and JOB FAIL in DECKOPL. 
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Parameter 

UNI 


UN2 


USEPFG 


Description 

Called from common deck COMDISK. Specifies the alternative 
user name for input source files. Set UNI to a value only if you 
are rebuilding under a user name other than IUN. The default 
value is 0; it specifies that the user name under which the job is 
executing is used. 

NOTE _ 

If you specify a user name for UNI, DISKINS must be set to NO 
if the source program libraries have not been preloaded. 


Called from common deck COMDISK. Specifies the alternative 
user name for output source files. The default is to store the files 
using the same user name as the job is executing under. 

NOTE _ 

If you specify a user name with the UN2 parameter, OUTPRD 
must be set to NO. 


Called from common deck COMPFG. Specifies whether you want 
to save the PFGxxxx files created for use with a SYSGEN 
installation procedure. The default is USEPFG = NO. Residence of 
these files is controlled by the COMMOD parameters PFGPN and 
PFGPR. 

Value Description 

NO Only PFGxxxx files that previously existed are 

replaced with current PFGxxxx files. If a file does not| 
exist, no new permanent file is created. 

YES All PFGxxxx files are saved regardless of whether 

they existed previously. 
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Parameter 

USERF 


VARLIST 

VFYTAPE 


Description 

Called from common deck COMUSER. Specifies that there is a 
USER file for this installation procedure. The default value is 
null. This common deck is not used by the CCP/CROSS 
installation procedures. Refer to chapter 7 for information on 
USER files for CCP/CROSS. 

Value Description 

null A USER file is searched for only if a site 

includes the USERF parameter on the 
installation procedure call. For example: 

BEGIN,AAM2,INSTALL,USERF=AAM2M0D. 

If the USER file (in this case AAM2MOD) is 
not found, the installation procedure aborts. 
The site may choose any file name to be the 
USER file. If you specify USERF = UJOBNAM 
on the installation procedure call, it overrides 
the null value. 

UJOBNAM A USER file is searched for automatically. 

The file name that is looked for is a U 
concatenated with the first six characters of 
the installation procedure name (for example, 
UFTN5 or UTERMLI). If no file with that 
name is found, the installation procedure 
executes as usual and no user code is applied. 
If you specify USERF=filename on the 
installation procedure call, it overrides the 
UJOBNAM value. 

Called from common deck COMCCPV. Used by CCP/CROSS 
installation procedures only (refer to chapter 7). 

Called from common deck COMDEN. This parameter only affects 
copying deadstart tapes. Specifies verifications of all tape 
transfers; default is verification. Use the following setting to 
eliminate verification: 

(*N=) 
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DECKLIS Procedure 

The DECKLIS procedure lists the installation and support procedures on DECKOPL. 
Here is the format for the DECKLIS procedure call: 

BEGIN,DECKLIS,INSTALL,REP=n,MOD=fn,EXPAND=nn,MODIF,UMODE. 

NOTE _ 

Include all the key word = value parameters before using the keyword parameters. 


Parameter Description 

EXPAND = nn Specifies whether common deck calls are expanded. You can specify 

YES or NO. The default is YES. 


MOD=fn Specifies the name of a modification set file to add to the PL for 

listing purposes. If the file is local, a permanent file of the same 
name is ignored. The PL is not permanently updated. 

MODIF Includes the default Modify list options on the listing. 

REP = n Specifies the number of additional copies to be printed. The default 

is 0. 


UMODE Lists only modified decks; used in conjunction with the MOD=fn 

parameter. 

Here are some examples of calls to the DECKLIS procedure: 


BEGIN,DECKLIS,INSTALL,M0D=C0MM0D,UMODE. 


BEGIN.DECKLIS,INSTALL.EXPAND=N0. 
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Disk Installations 

If you want to perforin your installation with the source program libraries on disk, 
which allows the installation procedures to manage disk files for you, change the 
DISKINS parameter in file COMMOD to YES. 

You can preload all the source files to disk before beginning this process, or you can 
let the installation procedures load them one at a time as they are needed. If you 
want to preload your files, refer to Using PFLOAD, later in this section. 

Each installation procedure calls the procedure PRDIN. At the first reference to the 
product release file, PRDIN looks for a local file of the correct name (for example, 
NAM5). If the file is not local, PRDIN attempts to attach the file from disk. If the 
file is not on disk, PRDIN issues a RECLAIM command to load the file from the 
permanent file tapes and then stores the file on disk. 

The disk files are given the name of the product source file concatenated with the 
value of PSRIN. For example, the disk file for NAM5 at PSR level 999 would be 
NAM5999 (PSRIN defaults to the current release level number). Output program 
libraries are given the name of the product concatenated with the value of PSROUT. 

By default, output program libraries are not written (OUTPRD = NO) and the value of 
PSRIN is the same as the value of PSROUT. That value is the current release level 
number. Because of this naming convention, if you want to write output program 
libraries (OUTPRD = YES), you must change the value of PSROUT so that it is 
different from the value of PSRIN. 

The parameters OUTPRD, PSRIN, and PSROUT are common parameters. Refer to 
COMMOD File Parameters, earlier in this chapter. 

Using PFLOAD 

The quickest way to preload your files is to use PFLOAD. The permanent file tapes 
were written by the RECLAIM utility, which produces a tape format compatible with 
PFDUMP and PFLOAD. However, when you are using PFLOAD to preload your files, 
note the following: 

• You should specify the OP = Z and UD parameters since Control Data maintains 
these files using Mass Storage Extended (MSE). 

• To force PFLOAD to load files to the proper user index, you must specify the DI 
parameter. 

• If you are loading a family device, you must specify the FM and DD parameters. 

• If you are loading an auxiliary device, you must specify the PN parameter. 

• If you are loading multiple disk packs, you might want to use the OP=L option 
to cause PFLOAD to perform load leveling. 

• For more information about PFLOAD, refer to the NOS Version 2 Analysis 
Handbook. 

All source program libraries are loaded with names of the format xxxxpsrin where 
xxxx is the 4-character product name (such as TEXT or NAM5) and psrin is the value 
of the PSRIN parameter which, by default, is the current release level number. 
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Thus, the source program library for NAM5 at PSR level 999 would be loaded with the 
name NAM5999. The name for the composite OPL is OPLpsrin; thus, for the release at 
PSR level 999, the name would be OPL999. 

All other files are given names using the format PFGxxxx, where xxxx is the 
4-character product name. 

The PFGxxxx files are used by SYSGEN. Refer to the SYSGEN command in chapter 
8 if you want to have SYSGEN use these disk files or if you want to purge the files 
and have SYSGEN use the files from tape. 

Disk Installation with Auxiliary Packs 

This type of installation uses the same steps as normal disk installation. However, you 
must change the parameter defaults on the common decks that contain the pack name 
and type definitions. The released defaults are null. Each product source file is 
assigned to one of the common decks named COMD1, COMD2, COMD3, COMD4, or 
COMXOPL. The parameters in these decks define the pack name and type for the disk 
pack location of the input and output source files. Normal and auxiliary program 
library assignments are listed in table 9-1. 

Each of the common decks contains four parameters. Use the first two parameters to 
define the disk pack name and type for storage of the input source file. Use the other 
two parameters to define the assignment for the output source file which you can 
assign to a different disk pack. 

Each product source file that also serves as an auxiliary program library requires a 
second common deck defining its disk pack location. The second common deck is used 
in installation procedures that use the auxiliary program library. This second deck 
describes the auxiliary program library disk location. It is named using the following 
format: 

COMXa 

Parameter Description 

COMX Identifies an auxiliary common deck in DECKOPL. 

a One-character, identical to the last character of the common deck used 

by PRDIN to locate the input product file. 

Example: 

The RHC product file has its disk assignment in COMD3. Product RHF uses RHC as 
an auxiliary program library and, thus, includes the deck COMX3. The pack 
assignment could be as follows: 

C0MD3 C0MX3 

PN=PACKY 
PR=DJ 
PN0=PACKX 
PRO=DJ 


PN3=PACKX 

PR3=DJ 
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Table 9-1. Source File and Auxiliary PL Assignments 


Common 

Deck 

Installation 

Procedure 

Auxiliary 
Common 
. Deck 1 

Source 

File 

Required 

Aux PLs 2 

COMD1 

AAM2 

COMX1 

AAM2 


COMDi 

APL2 


APL2 

X 

COMD1 

BAM 


BAM1 

1 

COMDI 

BASIC3 


BAS3 

X,1 

COMDI 

BIT8 


BIT8 


COMDI 

CCG 

COMX1 

CCGl 


COMDI 

CDCS2 


CDCS 

X,1 

COMDI 

CID 


CID1 

X 

COMDI 

COBOL5 


COB5 


COMDI 

COMPASS 

COMX1 

CPS1 


COMDI 

DCL 


DCL2 


COMDI 

DDL3 

COMX1 

DDL3 

1 

COMDI 

FCL1 


FCL4 

1 

COMDI 

FCL2 


FCL4 

1 

COMDI 

FCL5 


FCL5 

1 

COMDI 

FDBF 


FDBF 

1 

COMDI 

FORM 


FORM 


COMDI 

FTN4 


FTN4 

1 

COMDI 

FTNTS 


FTI4 

1 

COMDI 

FTN5 


FTN5 

1 

COMDI 

F45 


F451 

1 

COMDI 

LOADER 


LDR1 


COMDI 

PASCAL 


PASC 

X 

COMDI 

PMD 


PMD5 

1 

COMDI 

QU3 


QU31 

x,l 

COMDI 

SORTS 


SRT5 


COMDI 

SYMPL 


SYMP 


COMDI 

TEXT 

COMX1 

TEXT 


COMDI 

TEXTIO 


TXIO 


COMDI 

UPDATE 


UPD1 

1 

COMD2 

TCPH 


TCPH 

X,l,2 

COMD2 

CHA1 


CHA1 

X,2 

COMD2 

MCS 


MCSl 

X,2 

COMD2 

NAM5 

COMX2 

NAM5 

X 

COMD2 

PSU 


PSU1 

X 

COMD2 

RBF5 


RBF5 

X,2 

1. A common deck name in 

this column identifies the 

source file 

as one also used as 

an auxiliary PL. 




2. Each letter or digit in this column refers to common decks for auxiliary PLs 

needed by this installation procedure. For example, X 

means COMXOPL, 1 means 

COMX1, 2 

means COMX2, 

and so forth. 




(Continued) 
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Table 9-1. Source File and Auxiliary PL Assignments (Continued) 

Auxiliary 


Common Installation Common Source Required 

Deck Procedure Deck 1 File Aux PLs 2 


COMD3 

AP1I 

API I 


COMD3 

AP1L 

MMCL 


COMD3 

BINEDIT 

BINE 

1 

COMD3 

CCL 

CCL1 

X,1 

COMD3 

CEDI AG 

CEDG 

X 

COMD3 

DUAL 

DUAL 

X,1 

COMD3 

FCS3 

FCS3 


COMD3 

FORMAT 

FMAT 

X 

COMD3 

HCD 

ZHCD 


COMD3 

ITF 

ITF1 

X,3 

COMD3 

LCS3 

LCS3 


COMD3 

MMCL 

MMCL 


COMD3 

MODOPL 

COMXOPL OPL 


COMD3 

MSSI 

MSSI 

X 

COMD3 

NSS 

NSSl 

X 

COMD3 

PFTF 

PFTF 

X 

COMD3 

RHC 

COMX3 RHC1 


COMD3 

RHF 

RHF1 

X,3 

COMD3 

RHP 

RHP1 

X,3 

COMD3 

TDU 

TDU1 

X 


FSE 


X 


HSIO 


X 


IAF 


X 


MMF 


X 


MSE 


X 


NIP5870 


X 


NOS 


X 


NOS2B 


X 


OSLIB 


X 


OSTEXT 


X 


RDFEX 


X 


TAF 


X 


TOOLS 


X 


TRACER 


X 


XEDIT 


X 


1. A common deck name in this column identifies the source file as one also used as 
an auxiliary PL. 


2. Each letter or digit in this column refers to common decks for auxiliary PLs 
needed by this installation procedure. For example, X means COMXOPL, 1 means 
COMX1, 2 means COMX2, and so forth. 
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GENDST Procedure 

Use the GENDST procedure to merge the binaries on file PRODUCT with a base 
deadstart file and generate a new deadstart file. The GENDST procedure ensures that 
there are no conflicts between IAF and RDF on the new deadstart file. 

Here is the format of the GENDST call: 


BEGIN,GENDST,INSTALL,SYSTEM=odt,NEW=ndt,D=dens11 y,LIST=1ist. 


Parameter 
D = density 


LIST = list 


NEW = ndt 


SYSTEM = odt 


Description 

Tape density option. If this parameter is omitted, the value in 
deck COMDEN set in COMMOD is used. The default is PE. 

The option applies to both odt and ndt. Here are the values you 
can specify for tape density: 


Value Description 


HY 

800 cpi (7-track). 

HD 

800 cpi (9-track). 

PE 

1600 cpi (9-track). 

GE 

6250 cpi (9-track). 


Local file name for the listing file. The default file name is 
OUTPUT. If you run GENDST interactively and want to save 
the listing file or do not want it to appear at the terminal, 
specify a different file name. 

Local file name for the new deadstart file. If file ndt is 
preassigned, the new deadstart file is written on it; otherwise, a 
tape label request is issued with a VSN = NDT. The default file 
name is NEW. 

Local file name for the old deadstart file. If file odt is 
preassigned, it becomes the base deadstart file; otherwise, a 
tape label request is issued with a VSN = ODT. The default file 
name is SYSTEM. 


Run a job similar to the following to add site-pfovided binaries and deadstart decks to 
the new deadstart file. Create file USERD so it contains the LIBEDIT directives to 
make these additions. (For information on LIBEDIT directives, refer to NOS Version 2 
Reference Set, Volume 3.) 

Job Comments 

job command. 

USER,username,password,fami 1yname. 

GET,USERD. USERD contains the LIBEDIT directives. 

GET,lfn=pfn. lfn (permanent file name is pfn) contains the 

modified deadstart decks, lfn must appear in the 
USERD file as *FILE lfn. 

BEGIN,GENDST,INSTALL. Parameters are not required if you use the 

system defaults. 
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MISCGET Procedure 

Code that may correct a specific user site problem but that has not been fully tested is 
released on the file MISCPL. This file, if it exists, was created during the setup of 
installation files. The modifications are properly formatted (Update or Modify) for the 
intended program library. 

To list the modification set headers and the decks containing calls to the modification 
sets, use the following commands: 

BEGIN .MISCGET,INSTALL,HISTORY. 

ROUTE,USER,DC=PR. 

You can extract code from MISCPL using any of the following methods: 

• To extract all modification sets for a product, use the following command: 

BEGIN,MISCGET,INSTALL,PRD=name. 

Replace name with the name of the deck for the product. 

• To extract one modification set, use the following command: 

BEGIN.MISCGET,INSTALL,MOD=modset. 

Replace modset with the name of the required modification set. 

• To extract selected modification sets, use the following commands: 

NOTE,1fn,NR.+.modname1+...+.modnamen 
BEGIN,MISCGET,INSTALL,MISCIN=1fn. 

These calls to MISCGET append the modification sets to the local file USER. You 
should then save file USER as a permanent file for later use by the corresponding 
installation procedure. 


REPORT Procedure 

To obtain statistics on all completed installation procedures, run a job that contains 
this command. The job output indicates the resources used for each installation 
procedure and whether the procedure passed or failed. 

BEGIN,REPORT,INSTALL,XC. 

NOTE _ 

The REPORT procedure uses the direct access file REP which is the FTN5 binary 
that actually performs the resource calculation. If the binary file cannot be found or 
if the XC keyword is present, REP is recompiled prior to generating the report. 
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RESETP Procedure 

You can use the RESETP procedure to reduce the size of files PRODUCT and 
DIRFILE. This procedure makes more disk space available and speeds up the 
subsequent LIBEDITs of more binaries into file PRODUCT. 

Initially, procedure SEED creates the file PRODUCT with user libraries that are used 
by the installation procedures, and creates DIRFILE with entries for those ULIBs. 

The installation procedures subsequently add binaries to the file PRODUCT and 
directives to file DIRFILE. Only those user libraries used by subsequent installation 
procedures are required to remain on file PRODUCT after GENDST creates a new 
deadstart tape. 

To use the RESETP procedure to reduce the size of files PRODUCT and DIRFILE, 
follow these steps: 

1. Run GENDST to create a new deadstart tape. 

2. After writing the new deadstart tape, enter this command: 

BEGIN,RESETP,INSTALL. 
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SETUP Procedure 


The SETUP procedure generates the permanent file INSTALL, which contains all 
installation procedures. The SYSGEN(SOURCE) function initially loads the permanent 
files needed for customizing an installation. Refer to Loading Permanent Files in 
chapter 8 for a complete list. SETUP can also perform the following functions: 

• Create INSTALL from DECKOPL with optional modifications against DECKOPL. 

• Rename file INSTALL to a specified name. 

• Create a 63-character set version of procedures on INSTALL. 

• Convert DECKOPL and INSTALL to a 63-character set format. 

• Replace DECKOPL with an updated DECKOPL. 

Here is the format for calling SETUP: 

BEGIN,SETUP,INSTALL,NEWPL,MOD=fi1ename,DF63,CV63,INSTALL=fi1ename. 


Parameter Description 

CV63 Converts DECKOPL to 63-character set format. 

DF63 Selects 63-character set version of installation procedures for 

inclusion on file INSTALL. 


INSTALL=filename Creates or replaces the procedure file specified. The default 

is INSTALL. If you omit the INSTALL keyword, procedure 
file INSTALL is not created or replaced. 

MOD = filename Applies modsets from the specified file to DECKOPL; the file 

can be a local file or a permanent file. If you change any 
default parameters in COMMOD and you also have your own 
local changes to DECKOPL, append your changes to file 
COMMOD. Then use MOD = COMMOD in your procedure 
call. If MOD is omitted, no modifications are applied. 

NEWPL Replaces DECKOPL with a modified DECKOPL. If NEWPL 

is omitted, DECKOPL is not replaced. 


Example: 

The following sample call to the SETUP procedure applies modifications from file 
COMMOD against the DECKOPL installation procedures and creates a new INSTALL 
procedure file. DECKOPL is not updated. 

BEGIN,SETUP,INSTALL,MOD=COMMOD,INSTALL. 
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Account Dayfile 

The account dayfile provides a history of system usage. It also provides information 
necessary for accurate billing and system usage and analysis. 

APRDECK 

The APRDECK (Auxiliary Mass Storage Parameter Deck) is a text record on the 
deadstart file. The entries in this deck specify flawed disk areas. A flawed area is 
one that cannot be read from or written to by the system. 

ASCII 

American National Standard Code for Information Interchange. The standard 
character set and code used for information interchange between computer systems. 

Auxiliary Device 

Mass storage device that is not part of a permanent file family. Auxiliary devices can 
contain direct or indirect access permanent files. 

Batch Critical Update (BCU) 

A binary correction to CDCNET or Dual State. 

Batch Origin Job 

A job submitted from a batch terminal. 

BCU 

Refer to Batch Critical Update. 

CCP 

Refer to Communications Control Program. 

CDCNET 

Refer to Control Data Distributed Communications Network. 

CDCS 

Refer to CYBER Database Control System. 

Central Memory (CM) 

The main storage device whose storage cells (words) can be addressed by a computer 
program and from which instructions and data can be loaded directly into registers. 

Central Processor Unit (CPU) 

The high-speed arithmetic unit that performs the addition, subtraction, multiplication, 
division, incrementing, logical operations, and branching instructions needed to 
execute programs. 

Channel Number 

The number of the data channel on which a peripheral device controller can be 
accessed. 
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Character 

Unless otherwise specified, references to characters in this handbook are to 7-bit 
ASCII code characters. 

Checkpoint 

The process of writing to a magnetic tape or mass storage file a copy of your job’s 
central memory, the system information used for job control, and the names and 
contents of all assigned files that are identified in a CHECKPT request. 

CM 

Refer to Central Memory. 

CMRDECK 

The CMRDECK (Central Memory Resident Deck) is a text file on the deadstart file. 
The entries in this deck describe the central memory table sizes to be used by the 
system; this deck also specifies which EQPDECK, IPRDECK, APRDECK, and 
LIBDECK will be used by the system. 

Command 

A sequence of words and characters that call a system routine to perform a job step. 
A command is sometimes called a control statement. 

Communication Control Program (CCP) 

Software product used to control 255x Network Processing Units. 

Communication Line 

A complete communication circuit between a terminal and its network processing 
unit. 

Communication Network 

The portion of the total network comprising the linked network processing units. The 
communication network excludes the host computer and terminals and is 
approximately equivalent to the set of all network elements configured as part of the 
total network. 

Communications Supervisor (CS) 

A portion of the network software, written as an application program, that 
coordinates the network-oriented activities of the host computer and of the lines and 
terminals logically linked to it in a NAM/CCP network. 

Control Data Distributed Communications Network (CDCNET) 

The collection of compatible hardware and software products offered by Control Data 
Corporation to interconnect computer resources into distributed communications 
networks and that is compatible with Control Data Network Architecture (CDNA). 

Control Point Number 

The number of the control point to which a job is assigned while the job resides in 
central memory. The actual number of control points is an installation parameter. 
Before the job can execute, each central processor program must be assigned a control 
point. 

Control Statement 
Refer to Command. 
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Controller 

Hardware device that connects channels to peripheral devices. For example, a tape 
controller might connect up to eight tape units to one channel. 

CPU 

Refer to Central Processor Unit. 

CS 

Refer to Communications Supervisor. 

CYBER Database Control System (CDCS) 

The DMS-170 controlling module that provides the interface between an application 
and a database. 

Data Channel 

One of the 9 to 24 channels (12-bit) by which information passes between the 
peripheral processors and peripheral devices. Refer to Channel Number. 

Dayfile 

A chronological file created during job execution which forms a permanent accounting 
and job history record. Dayfile messages are generated by operator action or when 
some commands are processed. A copy of the dayfile is printed with the output for 
batch jobs. You must explicitly request it in an interactive job. 

DC 

Refer to Disposition Code. 

Deadstart 

The process of initializing the system by loading the operating system library 
programs and any of the product set from magnetic tape or disk. Deadstart recovery 
is reinitialization after system failure. 

Deadstart Sequencing 

The execution of a selected set of commands before normal system job scheduling is 
enabled. 

Default Value 

A fixed value supplied by the system for a missing parameter. 

Detached Job 

An interactive service class job removed from control of the interactive subsystem. It 
may or may not continue to execute, depending on the presence of commands in the 
command buffer or an active job step. Control is regained by recovering the EJT 
entry for the job. 

Device Interface (DI) 

CDCNET hardware for open system interconnections. The device interface houses 
processor boards in configurations that permit a network of various other data 
processing equipment. 

DI 

Refer to Device Interface. 


Revision L 


Glossary A-3 



Glossary 


Direct Access File 

A NOS permanent mass storage file accessed by attaching the original file to your 
job. All changes to this file are made on the file itself rather than a temporary copy 
of the file. Compare with Indirect Access File. 

DIS 

Refer to Job Display. 

Disk 

A unit composed of one or more flat, circular plates with magnetic material on both 
sides that is used to store large amounts of data or programs. 

Disk Pack 

A group of disks with magnetically encoded information. 

Display Code 

A 6-bit character code set used to represent alphanumeric and special characters. 
Displays 

Two console screens or a split screen used to display system and job information, 
operator messages, and contents of central memory. Through the console keyboard, 
the operator can control the operation of the system. The displays are identified by 
alphabetic characters. The most frequently used are the job status (B), system and 
local files (H), and dayfile messages (A). 

Disposition Code (DC) 

A 2-character mnemonic indicating the destination queue and format for processing a 
file named on a ROUTE function. 

DSD 

Refer to Dynamic System Display. 

Dual State 

The state in which two operating systems execute simultaneously on the same 
mainframe. NOS/VE and either NOS Version 2 or NOS/BE Version 1.5 are such 
partners. 

Dynamic System Display (DSD) 

The operating system program that provides communication between the operator and 
the system by accepting control information typed on the console keyboard and by 
displaying information pertinent to all jobs known to the system. DSD is permanently 
assigned to peripheral processor 1. 

ECS 

Refer to Extended Core Storage and Extended Memory. 

EJT 

Refer to Executing Job Table. 

EQPDECK 

The EQPDECK (Equipment Deck) is a text file on the deadstart file. The entries in 
this deck describe the hardware connected to your computer. These entries are used 
by the system to build the equipment status table (EST). 
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Equipment Number 

The number from 0 to 7 that identifies the setting on a peripheral device controller. 
Equipment Status Table (EST) 

A central memory resident table listing all defined equipment, parameters aff ecting 
their operation, and the status of the equipment. 

ESM 

Refer to Extended Semiconductor Memory. 

EST 

Refer to Equipment Status Table. 

EST Ordinal 

The number designating the position of an entry within the equipment status table 
(EST) established at each installation. Devices are identified in operator commands by 
EST ordinals. 

Executing Job Table (EJT) 

A central memory resident table that contains a 4-word entry for all executing jobs, 
including interactive service class jobs. It is used to control jobs that are executing at 
a control point and jobs that are rolled out. Every executing job in the system has an 
EJT entry. 

Extended Core Storage (ECS) 

A type of extended memory that is an option available for 6000 Computer Systems, 
CYBER 70 Computer Systems, CYBER 170 Computer Systems (except model 176), 
and CYBER 180 Computer Systems. The maximum size of ECS is two million words. 
ECS is equipped with a CPU port and optionally a distributed data path (DDP). (The 
CPU port cannot be connected to a CYBER 180-class mainframe.) See Extended 
Memory. 

Extended Memory (EM) 

An additional portion of memory available as an option. This memory can be used for 
program and data storage, but not for program execution. Special hardware 
instructions exist for transferring data between central memory and extended 
memory. Extended memory consists of either extended core storage (ECS), extended 
semiconductor memory (ESM), large central memory extended (LCME), unified 
extended memory (UEM), or STORNET. 

Extended Semiconductor Memory (ESM) 

A type of extended memory that is an option available for 6000 Computer Systems, 
CYBER 70 Computer Systems, CYBER 170 Computer Systems (except model 176), 
and CYBER 180 Computer Systems. The maximum size of ESM is 16 million words. 
ESM is equipped with a CPU port and one or more low-speed ports (LSP). (The CPU 
port cannot be connected to a CYBER 180-class mainframe.) See Extended Memory. 

Family Device 

Mass storage permanent file device associated with a specific system. A family may 
consist of 1 to 63 logical devices. Normally, a system runs with one family of 
permanent file devices available. However, additional families may be introduced 
during normal operation. This enables users associated with the additional families to 
access their permanent files via the alternate family. 
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Family Name 

A designation that the installation may give to a group of permanent file devices. 
Family Ordinal 

An index into the family ordinal table (FOT). The family ordinal is used to identify a 
unique family. 

Family Ordinal Table (FOT) 

A central memory resident table used to associate family names with family ordinals. 
Field Length (FL) 

The area in central memory allocated to a particular job. The only part of central 
memory that a job can directly access. 

File 

1. A set of information that begins at beginning-of-information (BOI), ends with 
end-of-information (EOI), and can be referenced by a local file name. 

2. That portion of a multiple file terminated by an end-of-file (EOF). 

3. Data recorded on a magnetic tape beginning after HDR1 label and ending before 
an EOF1 label. 

File Transfer Protocol (FTP) 

The Control Data application-to-application protocol that enables applications 
programs executing on one host system to exchange information with applications 
programs that execute on other host systems. 

FL 

Refer to Field Length. 

FOT 

Refer to Family Ordinal Table. 

FTP 

See File Transfer Protocol. 

IAF 

Refer to Interactive Facility. 

Indirect Access File 

A NOS permanent file accessed by making a temporary copy of the file (GET or OLD 
commands). You create or alter it by saving or substituting the contents of an 
existing temporary file (REPLACE or SAVE commands). Compare with Direct Access 
File. 

Interactive Facility (IAF) 

An application that provides a terminal operator with interactive processing 
capability. The interactive facility makes terminal input/output and file input/output 
appear the same to an executing program. 

Interactive Origin Job 

A job initiated from an interactive (time-sharing) terminal. 
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Job Display (DIS) 

A system peripheral processor program similar to the system display (DSD) program. 
DIS provides communication between a job in central memory and the operator at the 
console, and permits the operator to control execution of the program through the 
console keyboard. 

Job Sequence Name (JSN) 

The unique system-defined name assigned to every executing job or queued file. The 
JSN is a string of 4 alphabetic characters, or if the job is a subsystem, 3 
alphanumeric characters. 

Job Status 

A job attribute kept in the job’s executing job table (EJT) entry. It is used by the 
system to determine if a job is rolled in or rolled out. If a job is rolled out, the job 
status indicates why it was rolled out. 

JSN 

Refer to Job Sequence Name. 

Large Central Memory Extended (LCME) 

A type of extended memory that is an option available for CYBER 170 model 176. 

See Extended Memory. 

LCF 

Refer to Local Configuration File. 

LCME 

Refer to Large Central Memory Extended. 

LCN 

Refer to Loosely Coupled Network. 

LID 

Refer to Logical Identifier. 

Local Configuration File (LCF) 

A file in the host computer system containing information on the logical makeup of 
the communication elements of the host. The file lists the application programs 
available for execution in the host computer and the users who can access it. This is 
a NOS direct access permanent file. 

Local NPU 

An NPU that is connected to the host via a coupler. A local NPU always contains a 
host interface program (HIP) for processing block protocol transfers across host/local 
NPU interface. 

Logical Identifier (LID) 

A 3-character alphanumeric string used to identify a particular mainframe. LIDs are 
identified by your site. 

Login 

The procedure used to gain access to the system. 
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Logout 

The procedure used to end a terminal session. 

Loosely Coupled Network (LCN) 

A network of physically connected computer systems. The LCN environment allows 
jobs, data files, and messages to be transmitted from one computer system to another. 

Machine Identifier (MID) 

A 2-character identifier used to associate a specific machine with its access to a 
shared device. 

MAG 

Magnetic tape subsystem. 

Mainframe Device Interface (MDI) 

The standard CDCNET DI variant that interconnects a CYBER 170/180 mainframe 
with an Ethernet local area network. 

Mainframe Terminal Interface (MTI) 

The standard CDCNET DI variant that interconnects CYBER 170/180 host computers 
with terminals, workstations, and unit record equipment without requiring a local 
area network. 

Mass Storage 

The equipment used to hold temporary and permanent files within the system. 

Mass Storage Device 

An extended memory or disk unit which has defined logical attributes such as family, 
file residency, and so on. 

Mass Storage Table (MST) 

Table that contains an entry for each logical device in the configuration of mass 
storage devices currently available to the system. 

MDI 

Refer to Mainframe Device Interface. 

MID 

Refer to Machine Identifier. 

MST 

Refer to Mass Storage Table. 

MTI 

Refer to Mainframe Terminal Interface. 

Multimainframe System 

Network of physically and logically connected computer systems. 

NAD 

Refer to Network Access Device. 
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NAM 

Refer to Network Access Method. 

NCF 

Refer to Network Configuration File. 

NDL 

Refer to Network Definition Language. 

Network 

An interconnected set of network elements consisting of a host and one or more 
NPUs, DIs, and terminals. 

Network Access Device (NAD) 

The primary element in a loosely coupled network. Each NAD connects a computer 
system to the network. 

Network Access Method (NAM) 

A software product that provides a generalized method of using a communications 
network for switching, buffering, queuing, and transmitting data. NAM is a set of 
interface routines used by a terminal servicing facility for shared access to a network 
of terminals and other applications, so that the facility program does not need to 
support the physical structures and protocols of a private communications network. 

Network Configuration File (NCF) 

A network definition file in the host computer. This file contains information on 
network elements and permissible linkages between them. The status of the elements 
described in this file is modified by the NPU operator in the course of managing a 
NAM/CCP network. This is a NOS direct access permanent file. 

Network Definition Language (NDL) 

The compiler-level language used to define the network configuration file and local 
configuration file contents. 

Network Load File (NLF) 

A file containing CCP software to load into a 255x Network Processing Unit (NPU). 
Network Processing Unit (NPU) 

The collection of hardware and software that switches, buffers, and transmits data 
between terminals and host computers. 

Network Supervisor (NS) 

A portion of the network software, written as a NAM application program, that 
dumps and loads network processing units (NPUs) upon request in a NAM/CCP 
network. 

Network Validation Facility (NVF) 

A portion of the network software, written as a NAM application program, that 
performs application validation and all connection validation processing and supports 
login dialogue with the terminal user. 

NLF 

Refer to Network Load File. 


Revision L 


Glossary A-9 



Glossary 


NPU 

Refer to Network Processing Unit. 

NS 

Refer to Network Supervisor. 

NVF 

Refer to Network Validation Facility. 

Order-Dependent 

Used to describe items that must appear in a specific order, such as parameters. 

Order-Independent 

Used to describe items that need not appear in any specific order. Parameters, 
particularly those with keywords, may be order-independent. 

Origin Type 

A job attribute that indicates how a job entered the system. The four origin types are 
interactive origin, batch origin, remote batch origin, and system origin. 

OUTPUT 

The system-defined file which, by default, contains all the output from job processing. 
It is also known as the print or punch file. 

Peripheral Microcode 

Special type of software that resides in a peripheral controller. The microcode defines 
the functional characteristics of the controller. 

Peripheral Processor (PP) 

The hardware unit within the host computer that performs physical input and output 
through the computer’s data channels. 

Peripheral Processor Unit (PPU) 

First-level peripheral processor (FLPP). A PPU is contained in the mainframe in a 
multimainframe environment and operates synchronously with the mainframe. 

Permanent File 

A mass storage file that is catalogued by the system so that its location and 
identification are always known to the system. The system protects the file from 
unauthorized access according to privacy controls specified when the file was created. 

Physical Identifier (PID) 

The unique 3-character identifier of a specific host. 

PID 

Refer to Physical Identifier. 

PP 

Refer to Peripheral Processor. 

PPU 

Refer to Peripheral Processor Unit. 
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Printer Support Utility (PSU) 

Operating system software used to control the 533/536/585 printers. 

Procedure 

A user-defined set of instructions that can be referenced by name. The instructions 
consist of procedure directives and system commands. 

Procedure File 

A file containing one or more procedures. 

PSU 

Refer to Printer Support Utility. 

QFT 

Refer to Queued File Table. 

Queue Priority 

An attribute associated with input and output files. If all other factors are equal, 
queue priority is used to select the best file for processing. 

Queued File 

An input, print, plot, or punch file that has an entry in the queued file table (QFT). 
It is not assigned an EJT entry and is waiting to be selected for processing. 

Queued File Table (QFT) 

A central memory resident table containing a 4-word entry for all active input and 
output queue files. 

RBF 

Refer to Remote Batch Facility. 

Remote Batch Facility (RBF) 

A network application that provides a terminal operator with remote batch processing 
capabilities. RBF transfers input and output files between remote batch devices and 
NOS. 

Remote Batch Origin Job 
A job submitted from a remote batch terminal. 

Remote Host Facility (RHF) 

A central processor program that executes at a system control point. It performs data 
buffering and switching and is the intermediary between application programs and 
the network. 

Remote NPU 

A network processing unit linked to a host computer through other network 
processing units. 

RHF 

Refer to Remote Host Facility. 
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Rollout 

The removal of jobs from central memory to mass storage before execution is 
complete, so the control point and central memory can be assigned to another job. A 
job is rolled out when it is waiting for an external event, when its control point is 
needed by a higher priority job, or when it exceeds its central memory time slice. 

Rollout File 

A file containing a job (and system information) that has been temporarily removed 
from the main processing area of the system. 

SC 

Refer to Service Class. 

Scheduling Priority 

An attribute associated with an executing job available for job scheduling. Scheduling 
priority is used to select the best executing service class job for processing. 

Service Class (SC) 

An attribute associated with a queued file or executing job. Service class determines 
how the system services the job. 

STORNET 

A type of extended memory that is an option available for CYBER 170 Computer 
Systems (except model 176) and CYBER 180 Computer Systems. The maximum size 
of STORNET is 4 million words. STORNET is equipped with one or more low-speed 
ports (LSP), but is not equipped with a CPU port. See Extended Memory. 

Suspended Job 

An interactive job placed in an inactive state. Processing stops immediately and 
recovery information is copied to the rollout file. If the job’s EJT entry is recovered, 
processing resumes as if no interruption took place. 

SYSLIB 

Refer to System Library. 

System Job 

A job brought to a control point by the operator. 

System Library (SYSLIB) 

The collection of tables and object language programs residing in central memory or 
on mass storage that are needed to run the operating system and its product set. 

System Origin Job 
A job entered at the system console. 

TCP/IP 

Refer to Transmission Control Protocol/Internet Protocol. 

TCU 

Refer to Trunk Control Unit. 

TDI 

Refer to Terminal Device Interface. 
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Terminal Device Interface (TDI) 

The standard CDCNET D1 variant that connects terminals, workstations, and unit 
record equipment to a local area network. 

Transmission Control Protocol/Internet Protocol (TCP/IP) 

A suite of protocols that supports the Defense Advanced Research Projects Agency 
Network (ARPANET) activities. TCP/IP must be implemented within CDCNET for 
connectability to Defense Data Networks (MILNET or ARPANET) and to workstations 
that use TCP/IP. 

Trunk 

The communication line connecting two network processing units. 

Trunk Control Unit (TCU) 

The hardware part of a network access device (NAD) that interfaces with a network 
trunk. 

UEM 

Refer to Unified Extended Memory. 

UJN 

Refer to User Job Name. 

Unified Extended Memory (UEM) 

A type of extended memory that is available as an option for CYBER 180-class 
machines and models 865 and 875. UEM differs from other types of extended memory 
in that it is a portion of central memory and not a separate memory unit. See 
Extended Memory. 

Unit Number 

The setting of a hardware device. Used when more than one hardware unit can be 
connected to a controller. 

User Job Name (UJN) 

A 1- to 7-character alphanumeric name you specify to replace the system-defined job 
sequence name (JSN) for a queued file or executing job. 

Volume Serial Number (VSN) 

A 1- to 6-character identifier that identifies the volume of magnetic tape to the 
system. 

VSN 

Refer to Volume Serial Number. 
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Order of Products 

The order in which products appear on the deadstart tape is now controlled by 
DECKOPL in each installation procedure. The basic order is alphabetical. 

NOTE _ 

All ULIBs are in library 4. 


Arrangement of deadstart tape libraries: 


Library Description Contributing Installation Procedures 


1 

CTI (Fixed order) 

2 

(Fixed order) 

3 

NOS 

4 

All ULIBs 

5 

Miscellaneous items 

6 

AAM2 

7 

(empty) 

8 

APL2 

9 

BAM1 

10 

BAS3 

11 

BINE 

12 

BIT8 

13 

CCLl 

14 

CDCS 

15 

CEDG 

16 

CHA1 

17 

CID1 

18 

CML1 

19 

COB5 

20 

CPS1 

21 

DDL3 

22 

DUAL 

23 

FDBF 

24 

FORM 

25 

FMAT 

26 

FSE1 

27 

FTN4 

28 

FTN5 

29 

F451 

30 

IAF1/RDF1 

31 

ITF1 

32 

LDR1 

33 

MAP 

34 

MCSl 

35 

(empty) 


NOS, HSIO, MMF, Disk Microcode 

NOS, NOS2B 

Many 

TDU, PFTF, NIP5870, Misc. Microcode 
AAM2 

APL2 

BAM 

BASIC3 

BINEDIT 

BIT8 

CCL 

CDCS2 

CEDIAG 

CHA1 

CID 

COBOL5/COBOL5Q 

COMPASS 

DDL3 

DUAL 

FDBF 

FORM 

FORMAT 

FSE 

FTN4/FTNTS, FCL1, FCL2 

FTN5, FCL5 

F45 

IAF, RDFEX 
ITF 

LOADER 

MMCL, MSSI, AP1I 
MCS 
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Library 

Description 

Contributing Installation Procedures 

36 

MMFl 

MMF 

37 

MSE1 

MSE 

38 

(empty) 


39 

NAM5 

NAM5/NAM5D 

40 

(empty) 


41 

NSS1 

NSS 

42 

OSTX 

OSTEXT 

43 

PASC 

PASCAL 

44 

(empty) 


45 

PMD5 

PMD 

46 

PSU1 

PSU 

47 

QU31 

QU3 

48 

RBF5 

RBF5/RBF5D 

49 

RHF1 

RHF 

50 

(empty) 


51 

RHP1 

RHP 

52 

SRT5 

SORT5 

53 

SYMP 

SYMPL 

54 

TAF1 

TAF 

55 

TCP/IP/FTP/TELNET 

TCPH 

56 

TEXT 

TEXT 

57 

TXIO 

TEXTIO 

58 

TOOL 

TOOLS 

59 

TRCE 

TRACER 

60 

UPD1 

UPDATE 

61 

XEDT 

XEDIT 

62 

(empty) 


63 

(empty) 
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Permanent File Tapes 

This section lists all files on the permanent file tapes. All source files are listed first, 
followed by all PFGxxxx files (files processed by SYSGEN). At the end of the list are 
files received only on a component order. 

NOTE _ 

Your tape contains only the files for the products you have ordered. 





To see a list of all the files on your permanent file tapes, follow these steps: 

1. Load the RECLAIM database as described under Loading Permanent Files in 
chapter 8. 

2. Enter this command from your installation user name: 

RECLAIM,Z./LIST,UN=NS2psr i n 
Replace psrin with the release level. 

This generates a report that lists the names of all the files on the tapes in 
alphabetical order. Because the report is generated from information in the RECLAIM 
database, the permanent file tapes are not requested. 

All source files end with the value psrin, the current NOS release level. For example, 
the AAM2 source file would appear as AAM2999 at NOS level 999. The table does 
not list the psrin value. 

Unless otherwise noted, all source files contain one random formatted Update 
program library. 

Associated 
File DECKOPL 

Name Procedure Name Format Notes 


File 1. Program library in Modify format. 

File 2. APLLIB. Relocatable of APL. 

File 3. APLPROD. Absolute of APL. 

File 4. TAPLTST. APL verification jobs. 

File 5. TAPLOUT. Sample output for file 4. 
File 6. NEWSF. APLNEWS, news file. 

File 7. FILESYS. Workspace, file functions. 

File 8. FILES2. Workspace, file functions. 

File 9. APLNEWS. Workspace, information. 

File 10. CATALOG. Workspace, information. 
File 11. WSFNS. Workspace, general functions. 
File 12. TAPLWS. Workspace for APL 
verification. 

File 13. Reserved. 

API online diagnostics for MAP III and MAP 
IV. 

File 1. Sequential PL in Update format. 

File 2. CSTFU. 


File Formats B-3 


AAM2psrin AAM2 

APL2psrin APL2 


APlIpsrin AP1I 
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1 File 
| Name 


BAMlpsrin 

BAS3psrin 

BINEpsrin 

BIT8psrin 

CCGlpsrin 

CCLlpsrin 

CCPBpsrin 


CCPDpsrin 

CCPRpsrin 

CCPTpsrin 

CDCSpsrin 

CEDGpsrin 

CHAlpsrin 

CIDlpsrin 

C0B5psrin 


Associated 

DECKOPL 

Procedure Name Format Notes 


File 3. CSCMD. 

File 4. CSQMM. 

File 5. CSMAINT. 

File 6. CSVDMT. 

File 7. CS24KM. 

File 8. CSDS0P4. 

File 9. CSECS. 

File 10. CSECSTA. 

File 11. CSHSMT for 24K memory size. 
File 12. CSHSMT for 48K memory size. 
File 13. CSHSMT for 64K memory size. 
File 14. CSCMI. 

BAM 

BASIC3 

BINEDIT 

BIT8 

CCG 

CCL 


CCPPH1, CCPBLB File 1. CCP base - sequential PL in Update 
format. 

File 2. Expand and autolink binaries. 

File 3. Mux firmware (phase 1) load module. 

File 4. Dump bootstrap module. 

File 5. System autostart (SAM) load module. 

File 6. Symbol table for dump bootstrap load 
module. 

File 7. Combined binary library (BCMB) for 
generation of phase 2 variant load modules. 

File 8. Compiler listing for expand and autolink. 
File 9. CCP listing for phase 1 load module. 

File 10. CCP listing for dump bootstrap load 
module. 

File 11. CCP listing for system autostart load 
module. 

File 12. CCP assembly listing for BCMB. 

File 13. CCP Pascal listing for BCMB. 

CCP Online Diagnostics - sequential PL in 
Update format. 

CCP Remote Concentrator Products (LIP) - 
sequential PL in Update format. 

CCP 3270 Bisync TIP - sequential PL in Update 
format. 


File 1. Sequential PL in Update format. 

Files 2,3,4. Used by the COBOL5Q installation 
procedure. 


CCPPH1 

CCPPH1 

CCPPH1 

CDCS2 

CEDIAG 

CHA1 

CID 

COBOL5/COBOL5Q 
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Permanent File Tapes 


File 

Name 

CPSlpsrin 

CRSSpsrin 


DCL2psrin 


DDL3psrin 

FCL4psrin 

FCL5psrin 

FCS3psrin 


FDBFpsrin 

FMATpsrin 

FORMpsrin 

FTI4psrin 

FTN4psrin 

FTN5psrin 

F451psrin 


Associated 

DECKOPL 

Procedure Name Format Notes 


COMPASS 

CROSS 


DCL 


DDL3 

FCL1, FCL2 
FCL5 

FCS3 


FDBF 

FORMAT 

FORM 

FTNTS 

FTN4 

FTN5 

F45 


File 1. Sequential PL in Update format. 
File 2. Absolute binary for CROSS. 

File 3. Empty. 

File 4. Empty. 

File 5. Pascal cross-reference. 

File 6. MPLINK. 

File 7. MPEDIT. 

File 8. CCP Pascal compiler. 

File 9. Pascal compiler bootstrap. 

File 10. Empty. 

File 11. CROSS program listing. 

File 1. Sequential PL in Update format. 
File 2. SEGLOAD directives. 

File 3. Absolute for DCUPD. 

File 4. Absolute for DCSEL. 

File 5. Absolute for DCRPT. 

File 6. Absolute for DCRET. 

File 7. Absolute for DCCONVT. 

File 8. Absolute for DCUTL. 

File 9. Absolute for DCIDX. 

File 10. Absolute for DCGEN. 

File 11. Absolute for DCCONGN. 


File 1. Sequential PL in Update format. 

File 2. Binary data for FORTRAN file conversion 
processor (FCP) verification. 

File 3. Binary data for COBOL FCP verification. 
File 4. Absolute load module CBLFCP1 for 
COBOL FCP. 

File 5. Absolute load module CBLFCP2 for 
COBOL FCP. 

File 6. Absolute load module FTNFCP1 for 
FORTRAN FCP. 

File 7. Absolute load module FTNFCP2 for 
FORTRAN'FCP. 

File 8. FORTRAN binary syntax file CBLFCPM 
for COBOL FCP. 

File 9. FORTRAN binary syntax file FTNFCPM 
for FORTRAN FCP. 
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Permanent File Tapes 


File 

Name 

ITFlpsrin 

LCS3psrin 


LDRlpsrin 

MCSlpsrin 

MMCLpsrin 

MSSIpsrin 

NAM5psrin 

NSSlpsrin 

OPLpsrin 


PASCpsrin 
PFTFpsrin 
PMD5psrin 
PSU lpsrin 
QU31psrin 
RBF5psrin 
RHClpsrin 

RHFlpsrin 

RHPlpsrin 

SRT5psrin 

SYMPpsrin 

TCPHpsrin 

TDUlpsrin 


TEXTpsrin 
TXIOpsrin 
UPD lpsrin 


Associated 

DECKOPL 


Procedure Name 

Format Notes 

ITF 

LCS3 

File 1. Sequential PL in Update format. 

File 2. Absolute load module for LCS. 


File 3. FORTRAN binary syntax for LCS. 

File 4. Absolute load module COUP for 
COSY-to-Update file conversion. 

File 5. Absolute load module COPYCOB for 
COBOL-COPY-library file conversion. 

File 6. Binary data file for COSY-to-Update file 
conversion (file 1 of 2). 

File 7. Binary data file for COSY-to-Update file 
conversion (file 2 of 2). 

LOADER 

MCS 

MMCL, AP1L 

Sequential PL in Update format. 

MSSI 

NAM5/NAM5D 

Sequential PL in Update format. 

NSS 

This is a composite OPL of all the NOS Modify 
products you ordered. It may contain the PLs for 
NOS, FSE, HSIO, IAF, MMF, MSE, TAF, 

TOOLS, TRACER, and XEDIT. OPLpsrin also 
contains the input PLs for the installation 
procedures NIP5870, NOS2B, OSLIB, OSTEXT, 
RDFEX, TDU, and TERMLIB. 

PASCAL 

PFTF 

PMD 

PSU 

QU3 

RBF5/RBF5D 

RHC 

Program library in Modify format. 

RHF 

RHP 

SORT5 

SYMPL 

TCPH 

TDU 

File 1. TDUTOOL 1. 

File 2. TDUTOOL 2. 

File 3. TDUTOOL 3. 

TEXT 

TEXTIO 

UPDATE 
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Associated 
File DECKOPL 

Name Procedure Name Format Notes 


VSMlpsrin CCPVAR 


VSM2psrin 

CCPVAR 

VSM3psrin 

CCPVAR 

VSM4psrin 

CCPVAR 

VVlFpsrin 

CCPVAR 

VVILpsrin 

CCPVAR 

VV2Fpsrin 

CCPVAR 

VV2Lpsrin 

CCPVAR 

VV3Fpsrin 

CCPVAR 

VV3Lpsrin 

CCPVAR 

VV4Fpsrin 

CCPVAR 

VV4Lpsrin 

CCPVAR 

ZHCDpsrin 

HCD 


CCP variant SMI 

File 1. CCP variant (phase 2) load module. 

File 2. CCP PICB load module. 

File 3. Symbol table for CCP variant and PICB. 
File 4. CCP listing for CCP variant build 
(MPLINK). 

File 5. Listing of CCP variant build (MPEDIT). 
File 6. Listing of PICB build (Pascal, MPLINK, 
and MPEDIT). 

CCP variant SM2; same format as file VSM1. 
CCP variant SM3; same format as file VSM1. 
CCP variant SM4; same format as file VSM1. 
CCP variant V1F; same format as file VSM1. 
CCP variant VIL; same format as file VSM1. 
CCP variant V2F; same format as file VSM1. 
CCP variant V2L; same format as file VSM1. 
CCP variant V3F; same format as file VSM1. 
CCP variant V3L; same format as file VSM1. 
CCP variant V4F; same format as file VSM1. 
CCP variant V4L; same format as file VSM1. 
819 PP Driver. 


All of the following files are processed by SYSGEN. They are stored on the permanent 
file tapes and have this naming format: 


PFGxxxx 


where xxxx is a four-character product name (for example, APL2). 

The following table lists each file name, the file’s associated DECKOPL procedure 
name, the SYSGEN procedure which installs the file, and the format of the file. 

When a DECKOPL procedure is listed, it is the name of the procedure that generates 
the associated file. Many of the files listed do not have associated DECKOPL 
procedures. To install the files that do not have an associated DECKOPL procedure, 
you must either use the SYSGEN function or explicitly get the file from the tape by 
using the RECLAIM command or the SYSGEN(RECLAIM) function. 

All files loaded by SYSGEN(SOURCE,CCP) are marked with an asterisk (*). All 
other files are loaded by SYSGEN(FULL) or SYSGEN(FILES.vsn). 
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| File 
| Name 

| PFGAAAA 
I PFGAPL2 


PFGAP1I 


DECKOPL SYSGEN 

Procedure Procedure 

Name Name File Format/Notes 

LOADUSE SYSGEN data file. 

APL2 APL2 File 1. Empty file. 

File 2. APLLIB. Relocatable of APL. 
File 3. APLPROD. Absolute of APL. 
File 4. TAPLTST. APL verification job 
File 5. TAPLOUT. Sample output for 
file 4. 

File 6. NEWSF. APLNEWS, news file. 
File 7. FILESYS. Workspace, file 
functions. 

File 8. FILES2. Workspace, file 
functions. 

File 9. APLNEWS. Workspace, 
information. 

File 10. CATALOG. Workspace, 
information. 

File 11. WSFNS. Workspace, general 
functions. 

File 12. TAPLWS. Workspace for APL 
verification. 

File 13. Reserved. 

AP1I AP1I API Online Diagnostics for MAP III 

and MAP IV. 

File 1. CSTFU. 

File 2. CSCMD. 

File 3. CSQMM. 

File 4. CSMAINT. 

File 5. CSVDMT. 

File 6. CS24KM. 

File 7. CSDSOP4. 

File 8. CSECS. 

File 9. CSECSTA. 

File 10. CSHSMT (24K memory). 

File 11. CSCMI. 
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DECKOPL SYSGEN 

File Procedure Procedure 

Name Name Name 

PFGAP1L AP1L AP1L 


PFGBCU1 


PFGBCU2 


♦PFGCCPB CCPPH1/ CCPB 

CCPBLB 


PFGCCPL 

CCPLOAD 

CCPL 

♦PFGCCPU 


CCPU 

PFGCDCS 

CDCS2 

CDCS 


File Format/Notes 

MMCL files for API Online 
Diagnostics. 

File 1. AP1LIB1; Channel Coupled 
MAP IV-2X. 

File 2. AP1LIB2; Channel Coupled 
MAP IV-2X. 

File 3. AP1LIB3; Channel Coupled 
MAP IV-2X. 

File 4. AP1LIB1; ECS/CMI Coupled 
MAP III/IV. 

File 5. AP1LIB2; ECS/CMI Coupled 
MAP III/IV. 

File 6. AP1LIB3; ECS/CMI Coupled 
MAP III/IV. 

File 1. Installation procedures. 

File 2. RECLAIM database. 

File 3. RECLAIM dump of CDCNET 
permanent files. 

File 1. Dual State Source Library in 
NOS/VE format. 

File 2. VEMEM procedures. 

File 3. RECLAIM dump of dual state 
binaries for earlier NOS releases. 

File 1. Expand/autolink directives PL. 
File 2. Expand and autolink binaries. 
File 3. Mux firmware (phase 1) load 
module. 

File 4. Dump bootstrap module. 

File 5. System autostart (SAM) load 
module. 

File 6. Symbol table for dump bootstrap 
load module. 

File 7. Combined binary library 
(BCMB) for generation of Phase 2 
variant modules. 

File 8. Updated combined program 
library (PCMB). 

CCP NLFFILE. 

CCP USERBPS file. 

CDCS startup procedure. 
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I File 
| Name 

1 PFGCHA1 


PFGCHA2 

PFGCML1 

*PFGCODE 

*PFGCRSS 


PFGCSTD 

*PFGDBU1 

PFGDCL2 


PFGDCNS 


DECKOPL SYSGEN 

Procedure Procedure 

Name Name 

CHA1 CHAl 


CHA2 


CMLl 

CODE 


File Format/Notes 

File 1. Installation procedure. 

File 2. CHAl message template file, 
HTF_id_psrout. 

File 3. CHAl response file, HRF_id_ 
psrout. 

File 4. CHAl log file, HLF_id_psrout. 
File 5. CHAl NAMSTRT records. 

File 1. Installation procedure. 

File 2. NETOU template file, TF_id_ 
vvvv. 

Refer to the CML Reference Manual for 
specific file format information. 

CODEPL. 


CROSS CRSS 


CSTD 

DBU1 

DCL DCL2 


DCNS 


Cross Binary Install Permanent Files. 
File 1. Empty. 

File 2. Absolute binary for CROSS. 
File 3. Empty. 

File 4. Empty. 

File 5. Pascal cross-reference. 

File 6. MPLINK. 

File 7. MPEDIT. 

File 8. CCP Pascal compiler. 

File 9. PASCAL compiler bootstrap. 

File 1. COMPASS coding standards. 
File 2. SYMPL coding standards. 

DBUBIN. (For use by QU3.) 


Permanent files for Data Catalogue 2 
Version 2.0. 

File 1. Absolute 
File 2. Absolute 
File 3. Absolute 
File 4. Absolute 
File 5. Absolute 
File 6. Absolute 
File 7. Absolute 
File 8. Absolute 
File 9. Absolute 


for DCUPD. 
for DCSEL. 
for DCRPT. 
for DCRET. 
for DCCONVT. 
for DCUTL. 
for DCIDX. 
for DCGEN. 
for DCCONGN. 


File 1. Installation procedures. 

File 2. RECLAIM database. 

File 3. RECLAIM dump of CDCNET 
permanent files. 
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DECKOPL SYSGEN 
File Procedure Procedure 

Name Name Name 

♦PFGDECK DECK 


PFGDUAL DUAL DUAL 


PFGFSEl FSE FSE1/FSEH/ 

FSES 


PFGIAF1 IAF IAF1 


PFGITFl 

ITF 

ITF1 

PFGMAN1 


MAN1 

PFGMCS1 

MCS 

MCSl 

♦PFGMISC 


MISC 

PFGMMCL 

MMCL 

MMCL 

PFGMSE1 

MSE 

MSE1 


File Format/Notes 

DECKOPL permanent files. 

File 1. DECKOPL. 

File 2. INSTALL procedure file. 

File 3. COMMOD. 

File 4. GDIR program binaries. 

File 1. Dual State Source Library in 
NOS/VE format. 

File 2. VEMEM procedures. 

File 3. RECLAIM dump of dual state 
binaries for earlier NOS releases. 

File 1, record 1. Contains SMF startup 
procedure. 

File 1, record 2. FSEHELP file. 

File 1, record 3. FSTEACH file. 

File 1, record 4. FSEPROC file. 

File 1, record 5. SMFSTAT file. 

Interactive Facility Startup procedures. 
File 1, record 1. IAF startup procedure. 
File 1, record 2. IAFTM startup 
procedure. 

File 1, record 3. IAFTR startup 
procedure. 

ITF NAMSTRT startup record. 

Optional set of online manuals: 
procedures, source and bound copies of 
the manuals. 

File 1. Contains the installation 
procedure and documentation for all 
other files within PFGMAN1. 

MCS startup procedure. 

MISCPL. 

MAP III/IV-2x Macro Control Library 
Files. 

File 1. MAPLIBE - MAP III, MAP 
IV-23/25. 

File 2. MAPLIBC - MAP IV-20/21. 

File 1, record 1. MSE startup 
procedure. 

File 1, record 2. MSE slave startup 
procedure. 

File 1, record 3. MSE sample 
configuration file. 
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Permanent File Tapes 


DECKOPL SYSGEN 

File Procedure Procedure 

Name Name Name File Format/Notes 


PFGMSSI 

MSSI 

MSSI 

MSSI 3 Permanent Files. 

File 1. MAPCMI startup procedure. 

File 2. MAPECS startup procedure. 

File 3. MAPCH startup procedure. 

File 4. MSSIP - misc. MSSI/MMCL 
procedures. 

File 5. MJOBSPL - MSSI test jobs. 
Sequential PL in Update format. 

PFGNAMD 

NAM5D 

SWAP 

NAM5 trace/debug binaries. SYSGEN 
procedure SWAP is used to load these 
binaries. 

PFGNAM5 

NAM5 

NAM5 

NAM startup files. 

File 1. NAMSTRT file. 

File 2. NAM startup procedure. 

File 3. NAMNOGO startup procedure. 

PFGNDL1 


NDL1 

Network Definition File. 

File 1. NDL source file NDLDATA. 

File 2. Compiled NCFFILE of 
NDLDATA. 

File 3. Compiled LCFFILE of 
NDLDATA. 

PFGNIPB 


SWAP 

63-character set NIP5870 binaries. 
SYSGEN procedure SWAP is used to 
load these binaries. 

PFGNOSB 

NOS2B 

NOSB/HELP 

HELPLIB file. 

PFGNOS2 

NOS 

NOS2 

STAGE job startup procedure. 

PFGNSSl 

NSS 

NSSl 

NOS Scope Station startup procedure. 

PFGONLM 


ONLM 

Default set of online manuals: 
procedures, source and bound copies of 
the manuals. 

File 1. Contains the installation 
procedure and documentation for all 
other files within PFGONLM. 

PFGPFTF 

PFTF 

PFTF 

Protocol File Transfer Facility. 


File 1. Procedure RMUGET 
(64-character set version). 

File 2. Procedure RMUGET 
(63-character set version). 

File 3. User library PFTF (debug 
version). 
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DECKOPL 

SYSGEN 


File 

Procedure 

Procedure 


Name 

Name 

Name 

File Format/Notes 

*PFGPRPT 


PRPT 

History idents of NOS PSR code in 
current release. 

PFGPSU1 

PSU 

PSU1 

File 1. PSU NAMSTRT startup record. 
File 2. PSU default settings file, 
EVFULFN. 

PFGRBFD 

RBF5D 

SWAP 

RBF5 trace/debug binaries. SYSGEN 
procedure SWAP is used to load these 
binaries. 

PFGRBF5 

RBF5 

RBF5 

RBF NAMSTRT startup record. 

PFGRDFl 

RDFEX 

RDF1 

RDF startup procedure. 

PFGRHP1 

RHP 

RHP1 

RHP NAMSTRT startup record. 

PFGTAF1 

TAF 

TAF1 

Transaction Facility permanent files. 
File 1. TAF startup procedure. 

File 2. TASKLIB. 

PFGTCPH 

TCPH 

TCPH 

TCP/IP/FTP/TELNET NAMSTRT 
startup records. 

PFGTOOL 

TOOLS 

TOOL 

Maintenance tools files. 


File 1. SECART - Security audit 
reduction tool. 


File 2. MSGID - Security audit 
message file. 

PFGTLIB TERMLIB TLIB Terminal Definition Utility files. 

File 1. User library TERMLIB. 

File 2. TDUFILE. 

PFGXEDT XEDIT XEDT XEDIT help file, XEDITH. 

On component orders, you also get the following files: 

File 

Name Notes 

BLDLIB Contains a procedure to properly update all ULIBs from binaries in file 

PRODUCT. 

DSTDIR Contains LIBEDIT directives for the products in file PRODUCT. 

PRODUCT Contains all binaries for the deadstart tape. 


Revision L 


File Formats B-13 





63 -Character Set Installation 


C 


This appendix describes how to install a system with a 63-character set format. 

Installation Procedure 

To install a 63-character set system, follow these steps: 

1. Load the files necessary for installation (refer to chapter 6). 

2. Execute the following command to convert the Modify-formatted DECKOPL 
procedures to 63-character set format: 

BEGIN,SETUP,INSTALL,CV63.NEWPL. 

3. Execute the following command to create an INSTALL procedure file in 
63-character set format which includes code for a 63-character set installation: 

BEGIN,SETUP,INSTALL,DF63,INSTALL. 

NOTE _ 

Any future calls to SETUP should include the DF63 parameter. 

4. Run the UCOMMOD procedure to recreate file COMMOD. Modify COMMOD 
parameters, if necessary. 

BEGIN,UCOMMOD.INSTALL. 

Use the new COMMOD file to set up DECKOPL installation defaults. 

BEGIN,SETUP,INSTALL,DF63,INSTALL,MOD=COMMOD. 

5. Run the SEED procedure. Refer to chapter 6 for more information. 

6. Create a USER file for the MODOPL procedure, if needed. 

7. Execute the MODOPL procedure. The composite OPL is created in 63-character 
set format. Refer to chapter 6 for more information. 

8. If you are installing on a dedicated system, deadstart the system again using this 
IPRDECK entry: 

CSM=63. 

If you are installing on a production system, skip this step. 

9. Include the parameter CSET = C63 or CSET = A63 on the call to build TEXT. 

10. Continue with the installation. 
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File Conversions 

All text flies that are installed by SYSGEN should be converted to 63-character set 
format. Use the FCOPY command to convert the files. 

For example, to convert from display code in 64-character set to ASCII code in 
63-character set, use this command: 

FCOPY(P=o1dflie,PC=DIS64,N=newfi1e,NC=ASCI163,R) 

To convert from a 64-character set ASCII code to a 63-character set ASCII code, use 
this command: 

FCOPY(P=oldfi1e,PC=ASCI164,N=newf1le,NC=ASCII63,R) 

The following files (on the installation user name) are installed by SYSGEN and must 
be converted to 63-character set format because they are not recreated from the 
installation procedures: 

• USERBPS 

• NDLDATA 

• PSRRPT 

• SRB (ASCII 6/12) 

5870 Installation 

On a 63-character set system, the build procedure NIP5870 must be rerun. The job 
requires Pascal. If you did not order Pascal, you can install a 63-character set version 
by entering this command: 

X. SYSGEN(SWAP,densit y,NIP) 

Replace density with the tape density of the deadstart tape. 

For more information about SYSGEN(SWAP), refer to chapter 8. 

Protocol File Transfer Facility (PFTF) 

To obtain a 63-character set version of PFTF, enter the following command: 
X.SYSGEN(PFTF,C63) 

This command replaces the two files RMUGET and PFTFTR on user name LIBRARY. 
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The Remote Diagnostic Facility (RDF) allows use of an interactive terminal when 
networks are not yet installed. Thus, you can use RDF as an interface for using a 
NOS editor to create your deadstart deck files or configuration files. For more 
information on how to use RDF, see the NOS Online Maintenance Software Reference 
Manual. 

To initiate RDF, follow these steps: 

1. When you deadstart the system, make an EQPDECK entry that defines the 
two-port multiplexer to which the terminal you want to use is connected. (Check 
with your customer engineer (CE) to ensure that the terminal’s baud rate agrees 
with that set on the two-port multiplexer. Refer to the NOS Version 2 Analysis 
Handbook for the syntax of the entry.) 

2. After you deadstart the system, check the operator E,A. display for the equipment 
status of the two-port multiplexer. If the status is OFF, enter this command: 

ON.nn 

nn is the EST ordinal of the two-port multiplexer. 

3. Enable the RDF subsystem by entering these commands: 

SUBSYST. 

L.ENABLE,RDF. 

L.END. 

4. Initiate RDF by entering this command: 

RDF. 

5. Press the RETURN key on the terminal a few times. The login banner is 
displayed at the terminal. 

Using RDF is similar to using IAF/NAM, with the following exceptions: 

• To correct input, press the backspace key or CTRL-H. 

• To delete input, press the ESCAPE key. 

• To interrupt execution, press I or the BREAK key. 

• To terminate execution, press S or enter STOP. 

• To exit TEXT mode, press CTRL-C or the BREAK key. 

• The type-ahead feature is not available on RDF. 

• Full Screen Editor (FSE) does not function properly. 
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System Configurations 


E 


To minimize installation time and confusion and to establish conventions that enable 
better CDC service/support to users, the preferred configurations are defined in table 
E-l. 

Complete configurations are not defined in table E-l due to differing customer 
requirements. Conventions are specified for a base system. Systems configured 
according to the conventions provide these benefits: 

• Simplify the selection of peripheral equipment channels by the customer and 
customer engineering. 

• Allow the customer to easily deadstart NOS using the pre-defined configurations 
released on the deadstart tape. 
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System Configurations 


Table E-l. Preferred Configuration 


Channel 

CYBER 170/180 
Models 815, 

825, 835, 840(A), 
845, 850(A), 855 
860(A), 865, 
870(A), 875, 960, 
990, 994, 995 

CYBER 180 
Models 810, 830 
Group A 

CYBER 180 
Models 810, 830 
Group B 

CYBER 180 
Models 810, 830 
Group C 

0 

4 

First ISD RMS 

First ISD RMS 

First ISD RMS 

1 

First RMS 

+ 

First non-ISD 

RMS 

Third ISD RMS 

2 

Second RMS 

- 

- 

- 

3 

Third RMS 

+ 

Second non-ISD 
RMS 

Fourth ISD RMS 

4 

Fourth RMS 

4 

Third non-ISD 
RMS 

4 

5 

First 

Communications 

- 


- 

6 

Second 

Communications 

First ISMT MT 

First ISMT MT 

First ISMT MT 

7 

Third 

Communications 

Communications 

First 

Communications 

Communications 

10 

Console 

18002-2 Console 

18002-2 Console 

18002-2 Console 

11 

First MT 

4 

4 

4 

12 

Unit Record 

+ 

Unit Record 

4 

13 

+ 

- 

- 

- 

20 

+ 

Second ISD RMS 

Second ISD RMS 

Second ISD RMS 

21 

Fifth RMS 

4 

Fourth RMS 

4 

22 

Sixth RMS 

- 

- 

- 

23 

Seventh RMS 

4 

4 

4 

24 

Eighth RMS 

+ 

4- 

4 

25 

+ 

- 


- 


(Continued) 
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Table E-l. 

Preferred Configuration (Continued) 



Channel 

CYBER 170/180 
Models 815, 

825, 835, 840(A), 
845, 850(A), 855 
860(A), 865, 
870(A), 875, 960, 
990, 994, 995 

CYBER 180 
Models 810, 830 
Group A 

CYBER 180 
Models 810, 830 
Group B 

CYBER 180 
Models 810, 830 
Group C 

26 

+ 

ISD or ISMT 

ISD or ISMT 

ISD or ISMT 

27 

+ 

+ 

+ 

+ 

30 

+ 

- 

- 

- 

31 

Third MT 

+ 

First non-ISMT 
MT 

+ 

32 

Fourth MT 

+ 

Second non-ISMT 
MT 

+ 

33 

Second MT 

— 

_ 

_ 


Group A specifies channel assignments for an 810/830 using only Intelligent Small 
Disk (ISD) (834s and 836s) and Intelligent Small Magnetic Tape (ISMT) (639s) 
peripherals. 

Group B specifies channel assignments for an 810/830 with both ISD/ISMT peripherals 
and other CDC disk and tape peripherals. 

Group C specifies channel assignments for an 810/830 with the 18002-2 console 
option. 

The + symbol means the channel is available for CYBER channel peripheral 
connection. 

The - symbol means the channel is not available for CYBER channel peripheral 
connection. 
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We would like your comments on this manual to help us improve it. Please take a few minutes to fill out 
this form. 
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□ Manager □ As an overview 

□ Systems analyst or programmer □ To learn the product or system 

□ Applications programmer □ For comprehensive reference 

□ Operator □ For quick look-up 

□ Other___ □ Other__ 

What programming languages do you use? 


How do you like this manual? Answer the questions that apply. 


Yes Somewhat 
□ □ 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 

□ □ 


No 

□ Does it tell you what you need to know about the topic? 

D Is the technical information accurate? 

□ Is it easy to understand? 

□ Is the order of topics logical? 

□ Can you easily find what you want? 

□ Are there enough examples? 

□ Are the examples helpful? (□ Too simple? □ Too complex?) 

□ Do the illustrations help you? 

□ Is the manual easy to read (print size, page layout, and so on)? 

□ Do you use this manual frequently? 


Comments? If applicable, note page and paragraph. Use other side if needed. 


Check here if you want a reply: □ 


Name Company 

Address Date 

~Phone 


Please send program listing and output if applicable to your comment. 


